public static class Factory.SecurityPrincipal
extends java.lang.Object
Modifier and Type | Method and Description |
---|---|
static SecurityPrincipal |
fetchInstance(Connection connection,
java.lang.String name,
PropertyFilter filter)
Retrieves an object of the
SecurityPrincipal class by the specified connection and symbolic name. |
public static SecurityPrincipal fetchInstance(Connection connection, java.lang.String name, PropertyFilter filter)
SecurityPrincipal
class by the specified connection and symbolic name.
This method always makes a round-trip to the server. You can optionally include a filter
to control which properties to return with the object. If you pass in null
for the filter
parameter, this method returns values for all non-object
properties and returns placeholders for all object-valued properties. For more information,
see the description of the filter
parameter.connection
- A Connection
object for establishing the connection to the Content Engine server.name
- The name of the class instance to retrieve. Valid strings are the Id, the
short name, or the distinguished name. If the authentication provider is Microsoft Active Directory,
you can also specify the UPN.filter
- A PropertyFilter
object that represents information for
controlling which property values (and with what level of detail and recursion) to return.
If null
, this method returns values for all non-object properties and returns
placeholders for all object-valued properties (PropertyEngineObject
properties with a state of PropertyState.UNEVALUATED
or
PropertyState.REFERENCE
); any subsequent attempts to access an object-valued
property will cause an automatic round-trip to the server to fetch its value.© Copyright IBM Corporation 2006, 2015. All rights reserved.