Introduction

This project provides a number of network (http, DAV,servlet etc) related classes and methods for Bedework.

1. Util-args

Provides utility class to help handling of Main method arguments.

1.1. Using this project

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

      <dependency>
        <groupId>org.bedework</groupId>
        <artifactId>bw-util-args</artifactId>
      </dependency>

2. Util-caching

Provides:

  • A map which will be flushed after a certain time or when it reaches a certain size

  • Simple and lightweight pool implementation

  • A pool for shareable objects

2.1. Using this project

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

      <dependency>
        <groupId>org.bedework</groupId>
        <artifactId>bw-util-caching</artifactId>
      </dependency>

3. Util-directory

Provide access to directory services. If the Directory object is provided with a Properties object it will be queried for a number of properties. If they are absent or no Properties object is provided they will default to some value. Properties are defined in javax.naming.Context and are:

  • java.naming.factory.initial

  • java.naming.provider.url Service provider, e.g. ldap://ldap.example.com:389

  • java.naming.security.authentication e.g. "simple"

  • java.naming.security.principal e.g. cn=dirManager

  • java.naming.security.credentials Usually the password

The intention is that the Directory class should be able to represent various forms of directory, even a sequential input stream of records.

3.1. DirRecord

This class represents a directory record which may be built from a number of attributes, retrieved as a search result or read from some input stream.

We will implement some aspects of the ldif as defined in RFC 2849 within this class. These will be related to the content vs change records. By default, a DirRecord object will be a content record. However, we will allow the creation of change type records. Having this defined here allows applications to pass around DirRecord objects without any idea of the underlying implementation.

Currently the following is implemented:

content records

Consist of a dn with an associated set of attributes with values. No attribute options are implemented. Encoded strings may be converted incorrectly (need to check locale specifics)

change records
add

Implemented. Look just like content records.

delete

Implemented. Consist of a dn only.

others

all others are unimplemented. === Using this project Add the artifact(s) as a dependency to your project:

      <dependency>
        <groupId>org.bedework</groupId>
        <artifactId>bw-util-directory</artifactId>
      </dependency>
Note
need to do remaining modules…​

4. Reports