com.filenet.api.core

Class Factory.Group

java.lang.Object

com.filenet.api.core.Factory.Group

Enclosing class:

Factory

public static class Factory.Group
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
static Group	fetchInstance(Connection connection, java.lang.String name, PropertyFilter filter) Retrieves an object of the Group class by the specified connection and symbolic name.
static Group	getInstance(Connection connection, java.lang.String name) Retrieves an instance of the Group class by the specified connection and symbolic name.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static Group getInstance(Connection connection,
                                java.lang.String name)

Retrieves an instance of the Group class by the specified connection and symbolic name. This method does not verify the existence of the requested object on the server; it simply returns a local reference without making a round-trip to the server. The local reference is not affiliated with an object of this class type until you perform a function on the object (for example, fetch a property value) that causes a round-trip to the Content Engine server.

Parameters:

connection - A Connection object for establishing the connection to the Content Engine server.

name - The symbolic name of the class instance to retrieve.

Returns:

A reference to an object of the requested type.

fetchInstance

public static Group fetchInstance(Connection connection,
                                  java.lang.String name,
                                  PropertyFilter filter)

Retrieves an object of the Group 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.

Parameters:

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.

Returns:

An object of the requested type.