Interface TypeDescriptorInterface
public interface TypeDescriptorInterface
This interface describes the type dictionary entry for an public object
type.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final Stringstatic final Stringstatic final Stringstatic final Stringstatic final Stringstatic final Stringstatic final String -
Method Summary
Modifier and TypeMethodDescriptionbooleanReturns a boolean flag indicating if this object type allows children.ListGet a List of the permissions that are applicable to this type of object.StringGet the class name used to load an instance of this class.StringGet the name of the association to follow to get this object's container.StringGet the container type for this type.StringGet the default location for objects of this type.StringGet the description of this type.StringgetDescription(Locale locale) Get the type description for the specified locale.IcongetIcon()Return the Icon for this type.IcongetIcon(int size) Return the Icon for this type.byte[]getIconData(int size) Get the icon image byte data for this object type.StringGet the String with the icon name for this type.StringgetLabel()Get the label for this type.StringGet the plural version of the label for this type.StringGet the name of the Java class that implements the Logical Type for this definition.StringGet the metadata type used to represent this object in the server.StringgetPropertyValue(String key) Returns the value for an associated property.StringDeprecated.Consumers should use the getTemplate(ServerInterface) since the template is no longer loaded automatically.StringgetTemplate(ServerInterface server) Get the template for this object.ObjectReturns the TransportHandler for this object type.StringgetType()Get the type of this object.StringgetType(Locale locale) Get the localized type string for the specified locale.StringGet the non-localized type name.StringGet the usage version of this object type.booleanvoidsetApplicablePermissions(List permissionList) Set the List of permissions applicable to this type of object.voidsetLogicalTypeClassName(String logicalTypeClass) Set the name of the Java Class that implements the logical type for this definition.
-
Field Details
-
PROPERTY_CONTAINERASSOCIATION
static final String PROPERTY_CONTAINERASSOCIATION- See Also:
-
PROPERTY_LABELPLURAL
static final String PROPERTY_LABELPLURAL- See Also:
-
PROPERTY_TEMPLATE
static final String PROPERTY_TEMPLATE- See Also:
-
PROPERTY_LOGICALTYPECLASS
static final String PROPERTY_LOGICALTYPECLASS- See Also:
-
PROPERTY_LOCALIZERCLASS
static final String PROPERTY_LOCALIZERCLASS- See Also:
-
PROPERTY_HASCONTENTBACKING
static final String PROPERTY_HASCONTENTBACKING- See Also:
-
PROPERTY_SEARCHALLOWED
static final String PROPERTY_SEARCHALLOWED- See Also:
-
-
Method Details
-
getType
Get the type of this object. This is the localized type name, and can be used as the label for this type.- Returns:
- Type String for this object type.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getType
Get the localized type string for the specified locale.- Parameters:
locale- The locale to get the type string for.- Returns:
- The localized type string, if available. Otherwise, the default type string from the metadata is returned.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getTypeName
Get the non-localized type name. This is the string that will be used to index into the type dictionary, and the string that will be used as the PublicType attribute on metadata objects.- Returns:
- The non-localized type name.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getDescription
Get the description of this type.- Returns:
- The description of this type.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getDescription
Get the type description for the specified locale.- Parameters:
locale- The locale to retrieve the description for.- Returns:
- The localized description, if available. If no localized string is available, the description from metadata is returned.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getIconName
Get the String with the icon name for this type.- Returns:
- The icon name string, or null if none is defined.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getIcon
Return the Icon for this type. If no icon is defined, or the icon can't be loaded for some reason, null is returned.- Returns:
- The Icon for this object, or null if none is available.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getIcon
Return the Icon for this type. If no icon is defined, or the icon can't be loaded for some reason, null is returned.- Parameters:
size- The preferred size for the icon.- Returns:
- The Icon for this object, or null if none is available.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getIconData
Get the icon image byte data for this object type.- Parameters:
size- The size of the icon to retrieve.- Returns:
- the byte data for the icon if it exists, or null otherwise.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getUsageVersion
Get the usage version of this object type.- Returns:
- A String representation of the usage version of the object that this type entry represents.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getClassName
Get the class name used to load an instance of this class.- Returns:
- The fully qualified Java class name of the object to instantiate when this object is loaded.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getLabel
Get the label for this type.- Returns:
- The label String for this type.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getLabelPlural
Get the plural version of the label for this type.- Returns:
- The plural label for this type.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getContainerType
Get the container type for this type. For most types, this will be Folder, but secondary public objects can have other containers.- Returns:
- The type name for the valid container of this object type.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getTemplate
Deprecated.Consumers should use the getTemplate(ServerInterface) since the template is no longer loaded automatically.Get the template for this object. This is the template that will be used for all transport operations, delete, retrieval, etc.- Returns:
- The template string for this type.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getTemplate
Get the template for this object. This is the template that will be used for all transport operations, delete, retrieval, etc. The template will be loaded and saved for future access, so only one trip to the server per session will be required.- Parameters:
server- The server to use to retrieve the template.- Returns:
- The template string for this type.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getContainerAssociation
Get the name of the association to follow to get this object's container.- Returns:
- The name of the association to follow to get to the container.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getDefaultLocation
Get the default location for objects of this type.- Returns:
- the default location
- Throws:
ServiceExceptionRemoteException
-
getTransportHandler
Returns the TransportHandler for this object type.- Returns:
- transport handler
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.- See Also:
-
allowsChildren
Returns a boolean flag indicating if this object type allows children. If so, it should implement PublicObjectContainerInterface.- Returns:
- True if this type allows children, false otherwise.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getLogicalTypeClassName
Get the name of the Java class that implements the Logical Type for this definition.- Returns:
- A String with the Logical Type class name.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
setLogicalTypeClassName
Set the name of the Java Class that implements the logical type for this definition.- Parameters:
logicalTypeClass- The Logical Type class name.- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getMetadataType
Get the metadata type used to represent this object in the server.- Returns:
- The metadata type String.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
getApplicablePermissions
Get a List of the permissions that are applicable to this type of object.- Returns:
- A List of Strings with the permission names applicable to this object. This should always be non-null.
- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
setApplicablePermissions
Set the List of permissions applicable to this type of object.- Parameters:
permissionList- The List of Strings with the permission names applicable to this type of object.- Throws:
ServiceException- If a service level error occurs.RemoteException- In the event of remote object failure.
-
hasContentBacking
- Throws:
ServiceExceptionRemoteException
-
getPropertyValue
Returns the value for an associated property.- Parameters:
key- the property name- Returns:
- the property value
- Throws:
ServiceExceptionRemoteException
-