public interface CreateOp extends SPIOperation
Connector
developer is responsible for taking the attributes
given (which always includes the ObjectClass
) and create an object
and its Uid
. The Connector
developer must return the
Uid
so that the caller can refer to the created object.
The Connector
developer should make a best effort to create the
object otherwise throw an informative RuntimeException
telling the
caller why the operation could not be completed. It reasonable to use
defaults for required Attribute
s as long as they are documented.
Modifier and Type | Method and Description |
---|---|
Uid |
create(ObjectClass oclass,
Set<Attribute> attrs,
OperationOptions options)
The
Connector developer is responsible for taking the attributes
given (which always includes the ObjectClass ) and create an
object and its Uid . |
Uid create(ObjectClass oclass, Set<Attribute> attrs, OperationOptions options)
Connector
developer is responsible for taking the attributes
given (which always includes the ObjectClass
) and create an
object and its Uid
. The Connector
developer must return
the Uid
so that the caller can refer to the created object.
*Note: There will never be a Uid
passed in with the attribute set for this method.
If the resource supports some sort of mutable Uid
, you should create your
own resource-specific attribute for it, such as unix_uid.
attrs
- includes all the attributes necessary to create the resource
object including the ObjectClass
attribute and
Name
attribute.options
- additional options that impact the way this operation is run.
If the caller passes null, the framework will convert this into
an empty set of options, so SPI need not worry
about this ever being null.Copyright © 2013. All Rights Reserved.