https://github.com/lookfirst/sardine

an easy to use webdav client for java
https://github.com/lookfirst/sardine

Last synced: about 1 year ago
JSON representation

an easy to use webdav client for java

• Host: GitHub
• URL: https://github.com/lookfirst/sardine
• Owner: lookfirst
• License: other
• Created: 2013-04-18T19:01:30.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2025-04-24T06:39:33.000Z (about 1 year ago)
• Last Synced: 2025-05-12T04:40:52.702Z (about 1 year ago)
• Language: Java
• Size: 10.6 MB
• Stars: 595
• Watchers: 35
• Forks: 189
• Open Issues: 20
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-webdav - sardine - Java client based on Apache HTTP Client. `Apache-2.0` (Libraries / Java)

README

          
[![GitHub commit](https://img.shields.io/github/last-commit/lookfirst/sardine)](https://github.com/lookfirst/sardine/commits/master)

[![GitHub license](https://img.shields.io/badge/license-apache2-blue.svg)](https://raw.githubusercontent.com/lookfirst/sardine/master/LICENSE.txt)

[![Build Status](https://github.com/lookfirst/sardine/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/lookfirst/sardine/actions)

Sardine is useful for interacting with a webdav server and is much easier to programmatically manage remote files than with FTP.

I looked at the other Java webdav clients out there [slide](http://jakarta.apache.org/slide/), [Jackrabbit](http://jackrabbit.apache.org/) and [webdavclient4j](http://sourceforge.net/projects/webdavclient4j/). 

None of them do things quite the way I wanted.

The [UsageGuide](https://github.com/lookfirst/sardine/wiki/UsageGuide) documents how to use Sardine. If you are hungry, this is an appetizer for retrieving a directory listing from a remote webdav server:

```java

Sardine sardine = SardineFactory.begin();

List resources = sardine.list("http://yourdavserver.com/adirectory/");

for (DavResource res : resources)

{

     System.out.println(res);

}

```

Sardine is focused on being a useful library for common use cases. I also need it to support the latest version of [HttpClient](http://httpcomponents.apache.org/). It abstracts away the connection details and provides easy to use methods to accomplish webdav'y actions.

There is a [SardineTask](https://github.com/lookfirst/sardine/wiki/SardineTask) so that you can use Sardine directly in your Ant scripts.

Sardine uses JAXB to process XML responses from the webdav server. The generated code for this is based on the excellent webdav.xsd contained in the [Apache Wink](http://wink.apache.org/) project.

Sardine is fully stable and is being used in production on a very high traffic site (140+ concurrent connections 24/7). Click the Issues tab to submit requests. Most development is just adding new use cases. Check back often for new releases.

Questions? Please ask on our [mailing list](https://groups.google.com/forum/#!forum/sardine-dav). Issues? File an issue in the github issue tracker.

Sardine available under the Apache License 2.0.

If you like this library, I'd appreciate if you would blog/tweet about it. If you don't like it, well...