-
Notifications
You must be signed in to change notification settings - Fork 21
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
28b0a61
commit c426a40
Showing
103 changed files
with
7,770 additions
and
109 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
12 changes: 6 additions & 6 deletions
12
Java/jakarta/collectionsync/src/main/webapp/WEB-INF/wwwroot/js/package-lock.json
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
12 changes: 6 additions & 6 deletions
12
Java/jakarta/filesystemstorage/src/main/webapp/WEB-INF/wwwroot/js/package-lock.json
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 2 additions & 0 deletions
2
Java/jakarta/springboot3s3storage/.mvn/wrapper/maven-wrapper.properties
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.4/apache-maven-3.8.4-bin.zip | ||
wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.0/maven-wrapper-3.1.0.jar |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,61 @@ | ||
|
||
<h1 class="d-xl-block d-none">Spring Boot WebDAV Server Example with Amazon S3 Back-end, Java</h1> | ||
<p>This sample is a fully functional Class 2 WebDAV server that runs on the Spring Boot framework and stores all data in the Amazon S3 bucket. The WebDAV requests are processed on a /DAV/ context, while the rest of the website processes regular HTTP requests, serving web pages. Documents are being published from the Amazon S3 bucket with locks and custom attributed being stored in S3 Metadata. </p> | ||
<p>This sample can be downloaded in the <a title="Download" href="https://www.webdavsystem.com/javaserver/download/">product download area</a> as well as it is published on <a href="https://github.com/ITHit/WebDAVServerSamplesJava/tree/master/Java/javax/springboots3storage">GitHub</a>.</p> | ||
<p><span>This sample is using </span><a title="AJAX Library" href="https://www.webdavsystem.com/ajax/">IT Hit WebDAV Ajax Library</a><span> to display and browse server content on a default web page as well as to open documents for editing from a web page and save back directly to the server.</span><span></span></p> | ||
<p> </p> | ||
<h2>Requirements</h2> | ||
<ul> | ||
<li>Java 1.8.</li> | ||
<li>Lombok plug-in should be installed in your favorite IDE otherwise syntax error will be displayed</li> | ||
</ul> | ||
<h2>Running the sample</h2> | ||
<ol> | ||
<li> | ||
<p><strong>Set the license</strong>. Download your license file <a href="https://www.webdavsystem.com/javaserver/download/">here</a>. To set the license, edit the <code class="code">webdav.license</code> section in <code class="code"><em>\springboot\src\main\resources\application.properties</em></code> and specify the path to the <code class="code"><em>license.lic</em></code> file.</p> | ||
<pre class="brush:html;auto-links:false;toolbar:false">webdav.license=C:\License.lic</pre> | ||
The IT Hit Java WebDAV Server Library is fully functional and does not have any limitations. However, the trial period is limited to 1 month. After the trial period expires the Java WebDAV Server will stop working.<span></span></li> | ||
<li> | ||
<p><strong>Configure the Amazon S3 storage</strong>. You can either use an existing Amazon S3 bucket or create a new one. To create a bucket you can use the Amazon S3 <a title="web console" href="https://s3.console.aws.amazon.com/s3/home">web console</a>. </p> | ||
<p><img id="__mcenew" alt="" src="https://www.webdavsystem.com/media/2127/createb.jpg" rel="122335"></p> | ||
<p>After creating the S3 bucket you can create some folders and upload files for testing purposes.</p> | ||
</li> | ||
<li> | ||
<p><strong>Configure the Amazon S3 project settings.</strong> In <code class="code">application.properties</code> set the following properties:</p> | ||
<pre class="brush:xml;auto-links:false;toolbar:false"># Amazon S3 region | ||
webdav.s3.region= | ||
# Amazon S3 access key | ||
webdav.s3.access-key= | ||
# Amazon S3 secret access key | ||
webdav.s3.secret-access-key= | ||
# Amazon S3 bucket name | ||
webdav.s3.bucket= | ||
</pre> | ||
</li> | ||
<li> | ||
<p><strong>Configure the application server</strong>. Here we will configure the WebDAV server to run on the website non-root context (<code class="code">https://server/DAV/</code>). This setting is located in the <code class="code">webdav.rootContext</code> section in the <em><code class="code">\springboot\src\main\resources\application.properties</code>.</em></p> | ||
<pre class="brush:html;auto-links:false;toolbar:false">webdav.rootContext=/DAV/</pre> | ||
<span><span class="warn"><span>Note:</span> Some WebDAV clients (such as some old versions or Mini-redirector, Microsoft Web Folders, and MS Office 2007 and earlier) will fail to connect to a non-root server. They submit configuration requests to server root and if they do not get the response they will not be able to connect. <span>For this reason, this sample processes OPTIONS and PROPFIND requests on all folders, including on the site root (https://server/).</span> See also <a title="Working with MS Office" href="https://www.webdavsystem.com/javaserver/doc/ms_office_read_only/">Making Microsoft Office to Work with WebDAV Server</a> and <a title="Opening Docs" href="https://www.webdavsystem.com/ajax/programming/open-doc-webpage/opening_ms_office_docs/">Opening Microsoft Office Documents and Other Types of Files for Editing From a Web Page</a>.<br>This Spring Boot sample supports those configuration requests and works properly on a non-root context.<br></span></span></li> | ||
<li> | ||
<p><strong>Running the springboot sample. </strong>To start the sample, change the directory to <em><code class="code">springboot</code> </em>and execute the following command:</p> | ||
<pre class="brush:html;auto-links:false;toolbar:false">mvnw spring-boot:run</pre> | ||
<p>If everything was set up properly you should see a sample web page on <code class="code">https://server/DAV/</code> URL with a list of sample files and folders previously created in S3. Now you can open documents for editing, manage documents, as well as <a href="https://www.webdavsystem.com/server/access/">connect to the server with any WebDAV client</a>.</p> | ||
<p>If anything goes wrong examine the log file. For Spring Boot, the log file is usually located at <code class="code">springboot/log/engine.log</code>. You may also need to capture and examine the HTTP requests. See <a title="Troubleshooting" href="https://www.webdavsystem.com/javaserver/server_examples/troubleshooting/">this article</a> for more details. </p> | ||
</li> | ||
</ol> | ||
<h2>The Project Classes</h2> | ||
<p>On the diagram below you can see the classes in the WebDAV SpringBoot S3 sample:</p> | ||
<p><img id="__mcenew" alt="Class diagram of the sample Java WebDAV Server running on Spring Boot" src="https://www.webdavsystem.com/media/1879/springbootdiagram.png" rel="115963"></p> | ||
<p>To adapt the sample to your needs, you will modify these classes to read and write data from and into your storage. You can find more about this in <a title="Creating WebDAV Server" href="https://www.webdavsystem.com/javaserver/doc/">Creating a Class 1 WebDAV Server</a> and <a title="Class 2 / 3 Server" href="https://www.webdavsystem.com/javaserver/doc/create_class_2_webdav_server/">Creating Class 2 WebDAV Server</a> article as well as in the <a href="http://java.webdavsystem.com/">class reference documentation</a>.</p> | ||
<p> </p> | ||
<h3>See Also:</h3> | ||
<ul> | ||
<li><a title="Running" href="https://www.webdavsystem.com/javaserver/server_examples/running_webdav_samples/">Running the WebDAV Samples</a></li> | ||
<li><a title="Troubleshooting" href="https://www.webdavsystem.com/javaserver/server_examples/troubleshooting/">WebDAV Server Samples Problems and Troubleshooting</a></li> | ||
<li><a title="Creating WebDAV Server" href="https://www.webdavsystem.com/javaserver/doc/">Creating a Class 1 WebDAV Server</a> </li> | ||
<li><a title="Class 2 / 3 Server" href="https://www.webdavsystem.com/javaserver/doc/create_class_2_webdav_server/">Creating a Class 2 WebDAV Server</a></li> | ||
</ul> | ||
<p> </p> | ||
<h3 class="para d-inline next-article-heading">Next Article:</h3> | ||
<a title="WebDAV Server Example with Oracle Back-end, Java" href="https://www.webdavsystem.com/javaserver/server_examples/sql_storage/">WebDAV Server Example with Oracle Back-end, Java</a> | ||
|
Oops, something went wrong.