bw-caldav

A generic CalDAV server which interacts with a back end to access the resources. Provides a CalDAV server for Bedework.

A functioning CalDAV server can be built by fully implementing the abstract org.bedework.caldav.server.sysinterface.SysIntf class.

Supports most of the CalDAV and related RFCs:

• RFC4791 - CalDAV access
• RFC 5397 - WebDAV Current Principal Extension
• RFC 5689 - Extended MKCOL for Web Distributed Authoring and Versioning (WebDAV)
• RFC 5995 - Using POST to Add Members to Web Distributed Authoring and Versioning (WebDAV) Collections
• RFC 6638 - Scheduling Extensions to CalDAV
• RFC 7809 - Calendaring Extensions to WebDAV (CalDAV): Time Zones by Reference

Additionally, supports calendar sharing as implemented by other services.

Requirements

1. JDK 21
2. Maven 3

Using this project

Add the artifact(s) as a dependency to your project:

      <dependency>
        <groupId>org.bedework</groupId>
        <artifactId>bw-caldav-server</artifactId>
        <version>${bw-caldav.version}</version>
      </dependency>

      <dependency>
        <groupId>org.bedework</groupId>
        <artifactId>bw-caldav-util</artifactId>
        <version>${bw-caldav.version}</version>
      </dependency>

      <dependency>
        <groupId>org.bedework</groupId>
        <artifactId>bw-caldav-xml</artifactId>
        <version>${bw-caldav.version}</version>
      </dependency>

Reporting Issues

Please report issues via the github issues tab at

https://github.com/Bedework/bw-caldav/issues

Contributing

Contributions may take the form of suggested updates, bug fixes or documentation or just discussion. Pull requests may be submitted via github.

Please try to follow the coding conventions used in the source. Perhaps the main difference from many is the 2 space indents. No tab characters, please.

Building Locally

mvn clean install

Releasing

Releases of this fork are published to Maven Central via Sonatype.

To create a release, you must have:

1. Permissions to publish to the org.bedework groupId.
2. gpg installed with a published key (release artifacts are signed).

To perform a new release, use the release script in the bedework repository at https://github.com/Bedework/bedework:

1. Clone this repository and the bedework repository into the same directory
2. In that directory do:

./bedework/build/quickstart/linux/util-scripts/release.sh "" "-SNAPSHOT"

When prompted, indicate all updates are committed

For full details, see Sonatype's documentation for using Maven to publish releases.

Security - Vulnerability reporting

See SECURITY.md.