net.sf.michaelo.activedirectory

Class ActiveDirectoryDnsLocator.Builder

java.lang.Object

net.sf.michaelo.activedirectory.ActiveDirectoryDnsLocator.Builder

Enclosing class:

ActiveDirectoryDnsLocator

public static final class ActiveDirectoryDnsLocator.Builder
extends Object

A builder to construct an ActiveDirectoryDnsLocator with a fluent interface.

Notes:

1. This class is not thread-safe. Configure the builder in your main thread, build the object and pass it on to your forked threads.
2. An IllegalStateException is thrown if a property is modified after this builder has already been used to build an ActiveDirectoryDnsLocator, simply create a new builder in this case.
3. All passed arrays will be defensively copied and null/empty values will be skipped except when all elements are invalid, an exception will be raised.

Constructor Summary

Constructors

Constructor and Description
Builder() Constructs a new builder for ActiveDirectoryDnsLocator.

Method Summary

Modifier and Type	Method and Description
ActiveDirectoryDnsLocator.Builder	additionalProperty(String name, Object value) Sets an additional property not available through the builder interface.
ActiveDirectoryDnsLocator	build() Builds an ActiveDirectoryDnsLocator and marks this builder as non-modifiable for future use.
ActiveDirectoryDnsLocator.Builder	contextFactory(String contextFactory) Sets the context factory for this service locator.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Constructs a new builder for ActiveDirectoryDnsLocator.

Method Detail

contextFactory

public ActiveDirectoryDnsLocator.Builder contextFactory(String contextFactory)

Sets the context factory for this service locator.

Parameters:

contextFactory - the context factory class name

Returns:

this builder

Throws:

NullPointerException - if contextFactory is null

IllegalArgumentException - if contextFactory is empty

additionalProperty

public ActiveDirectoryDnsLocator.Builder additionalProperty(String name,
                                                            Object value)

Sets an additional property not available through the builder interface.

Parameters:

name - name of the property

value - value of the property

Returns:

this builder

Throws:

NullPointerException - if name is null

IllegalArgumentException - if value is empty

build

public ActiveDirectoryDnsLocator build()

Builds an ActiveDirectoryDnsLocator and marks this builder as non-modifiable for future use. You may call this method as often as you like, it will return a new ActiveDirectoryDnsLocator instance on every call.

Returns:

an ActiveDirectoryDnsLocator object

Throws:

IllegalStateException - if a combination of necessary attributes is not set