Package org.identityconnectors.framework.common.objects

Class OperationOptionsBuilder

java.lang.Object

org.identityconnectors.framework.common.objects.OperationOptionsBuilder

public final class OperationOptionsBuilder
extends Object

Builder for OperationOptions.

Constructor Summary

Constructors

Constructor	Description
OperationOptionsBuilder()	Create a builder with an empty set of options.
OperationOptionsBuilder(OperationOptions options)	Create a builder from an existing set of options.

Method Summary

Modifier and Type	Method	Description
OperationOptions	build()	Creates the OperationOptions.
static OperationOptionsBuilder	create()	Create a builder with an empty set of options.
Map<String,Object>	getOptions()	Returns a mutable reference of the options map.
OperationOptionsBuilder	setAttributesToGet(String... attrNames)	Sets the OperationOptions.OP_ATTRIBUTES_TO_GET option.
OperationOptionsBuilder	setAttributesToGet(Collection<String> attrNames)	Sets the OperationOptions.OP_ATTRIBUTES_TO_GET option.
OperationOptionsBuilder	setContainer(QualifiedUid container)	Convenience method to set OperationOptions.OP_CONTAINER
OperationOptionsBuilder	setOption(String name, Object value)	Sets a given option and a value for that option.
OperationOptionsBuilder	setPagedResultsCookie(String pagedResultsCookie)	Convenience method to set OperationOptions.OP_PAGED_RESULTS_COOKIE
OperationOptionsBuilder	setPagedResultsOffset(Integer pagedResultsOffset)	Convenience method to set OperationOptions.OP_PAGED_RESULTS_OFFSET
OperationOptionsBuilder	setPageSize(Integer pageSize)	Convenience method to set OperationOptions.OP_PAGE_SIZE
OperationOptionsBuilder	setRunAsUser(String user)	Set the run as user option.
OperationOptionsBuilder	setRunWithPassword(GuardedString password)	Set the run with password option.
OperationOptionsBuilder	setScope(String scope)	Convenience method to set OperationOptions.OP_SCOPE
OperationOptionsBuilder	setSortKeys(List<SortKey> sortKeys)	Convenience method to set OperationOptions.OP_SORT_KEYS
OperationOptionsBuilder	setSortKeys(SortKey... sortKeys)	Convenience method to set OperationOptions.OP_SORT_KEYS
OperationOptionsBuilder	setTotalPagedResultsPolicy(SearchResult.CountPolicy policy)	Sets the policy for calculating the total number of paged results.

Methods inherited from class java.lang.Object

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

Constructor Details

OperationOptionsBuilder

public OperationOptionsBuilder()

Create a builder with an empty set of options.

OperationOptionsBuilder

public OperationOptionsBuilder(OperationOptions options)

Create a builder from an existing set of options.

Parameters:

options - The existing set of options. Must not be null.

Method Details

create

public static OperationOptionsBuilder create()

Create a builder with an empty set of options.

Returns:

new and empty builder

Since:

1.5

setOption

public OperationOptionsBuilder setOption(String name,
 Object value)

Sets a given option and a value for that option.

Parameters:

name - The name of the option

value - The value of the option. Must be one of the types that we can serialize. See ObjectSerializerFactory for a list of supported types.

setAttributesToGet

public OperationOptionsBuilder setAttributesToGet(String... attrNames)

Sets the OperationOptions.OP_ATTRIBUTES_TO_GET option.

Parameters:

attrNames - list of Attribute names.

setAttributesToGet

public OperationOptionsBuilder setAttributesToGet(Collection<String> attrNames)

Sets the OperationOptions.OP_ATTRIBUTES_TO_GET option.

Parameters:

attrNames - list of Attribute names.

setRunWithPassword

public OperationOptionsBuilder setRunWithPassword(GuardedString password)

Set the run with password option.

setRunAsUser

public OperationOptionsBuilder setRunAsUser(String user)

Set the run as user option.

setScope

public OperationOptionsBuilder setScope(String scope)

Convenience method to set OperationOptions.OP_SCOPE

Parameters:

scope - The scope. May not be null.

Returns:

A this reference to allow chaining

setContainer

public OperationOptionsBuilder setContainer(QualifiedUid container)

Convenience method to set OperationOptions.OP_CONTAINER

Parameters:

container - The container. May not be null.

Returns:

A this reference to allow chaining

setPagedResultsCookie

public OperationOptionsBuilder setPagedResultsCookie(String pagedResultsCookie)

Convenience method to set OperationOptions.OP_PAGED_RESULTS_COOKIE

Parameters:

pagedResultsCookie - The pagedResultsCookie. May not be null.

Returns:

A this reference to allow chaining

Since:

1.4

setTotalPagedResultsPolicy

public OperationOptionsBuilder setTotalPagedResultsPolicy(SearchResult.CountPolicy policy)

Sets the policy for calculating the total number of paged results. If no count policy is supplied or paged results are not requested a default of SearchResult.CountPolicy.NONE will be used. This will result in no count being performed and no overhead incurred.

Parameters:

policy - The policy used to calculate total paged results

Returns:

A this reference to allow chaining

Since:

1.5

See Also:

• SearchResult.getTotalPagedResultsPolicy()
• SearchResult.getTotalPagedResults()

setPagedResultsOffset

public OperationOptionsBuilder setPagedResultsOffset(Integer pagedResultsOffset)

Convenience method to set OperationOptions.OP_PAGED_RESULTS_OFFSET

Parameters:

pagedResultsOffset - The pagedResultsOffset. May not be null.

Returns:

A this reference to allow chaining

Since:

1.4

setPageSize

public OperationOptionsBuilder setPageSize(Integer pageSize)

Convenience method to set OperationOptions.OP_PAGE_SIZE

Parameters:

pageSize - The pageSize. May not be null.

Returns:

A this reference to allow chaining

Since:

1.4

setSortKeys

public OperationOptionsBuilder setSortKeys(List<SortKey> sortKeys)

Convenience method to set OperationOptions.OP_SORT_KEYS

Parameters:

sortKeys - The sort keys. May not be null.

Returns:

A this reference to allow chaining

Since:

1.4

setSortKeys

public OperationOptionsBuilder setSortKeys(SortKey... sortKeys)

Convenience method to set OperationOptions.OP_SORT_KEYS

Parameters:

sortKeys - The sort keys. May not be null.

Returns:

A this reference to allow chaining

Since:

1.4

getOptions

public Map<String,Object> getOptions()

Returns a mutable reference of the options map.

Returns:

A mutable reference of the options map.

build

public OperationOptions build()

Creates the OperationOptions.

Returns:

The newly-created OperationOptions