SafeConfigurablePofContext Class

.NET API Reference for Oracle® Coherence Community Edition
(14.1.1.0)
E55634-01

SafeConfigurablePofContext is an extension of ConfigurablePofContext that can serialize and deserialize any valid POF user type, even those that have not been explicitly configured, as well as any .NET serializable types.

Inheritance Hierarchy

SystemObject
Tangosol.IO.PofConfigurablePofContext
Tangosol.IO.PofSafeConfigurablePofContext

Namespace: Tangosol.IO.Pof
Assembly: Coherence (in Coherence.dll) Version: 14.1.1.1 (14.1.1.1)

Syntax

Copy

public class SafeConfigurablePofContext : ConfigurablePofContext

The SafeConfigurablePofContext type exposes the following members.

Constructors

	Name	Description
	SafeConfigurablePofContext	Default constructor.
	SafeConfigurablePofContext(Stream)	Create a ConfigurablePofContext that will use the passed configuration information.
	SafeConfigurablePofContext(String)	Create a ConfigurablePofContext that will load configuration information from the specified locator.
	SafeConfigurablePofContext(IXmlElement)	Create a ConfigurablePofContext that will use the passed configuration information.

Top

Properties

	Name	Description
	Config	IXmlElement holding configuration information. (Inherited from ConfigurablePofContext.)
	ConfigLocation	Obtain the location of the configuration that the ConfigurablePofContext used to configure itself. (Inherited from ConfigurablePofContext.)
	IsInitialized	Determine if the ConfigurablePofContext has completed its initialization. (Inherited from ConfigurablePofContext.)
	IsInterfaceAllowed	Determine if the ConfigurablePofContext supports the configuration of user types by specifying an interface (instead of a class) for the .NET type. (Inherited from ConfigurablePofContext.)
	IsReferenceEnabled	Determine if Identity/Reference type support is enabled for this ConfigurablePofContext. (Inherited from ConfigurablePofContext.)
	IsSubclassAllowed	Determine if the ConfigurablePofContext supports the serialization of an object that is an instance of a sub-class of a configured type, but not actually an instance of a class of a configured type. (Inherited from ConfigurablePofContext.)

Top

Methods

	Name	Description
	AppendDefaultSerializerToUserTypes	Process <default-serializer> element from specified xml configuration and appends information about serializer to each <user-type> element within <user-type-list> unless user type already has serializer specified. (Inherited from ConfigurablePofContext.)
	CheckNotInitialized	Verify that the ConfigurablePofContext has not already been initialized. (Inherited from ConfigurablePofContext.)
	CreatePofConfig	Create a ConfigurablePofContextPofConfig object based on a configuration that was either provided as XML, or can be loaded from the specified (or default) URI. (Inherited from ConfigurablePofContext.)
	Deserialize	Deserialize an object from a stream by reading its state using the specified DataReader object. (Inherited from ConfigurablePofContext.)
	EnsureInitialized	Fully initialize the SafeConfigurablePofContext if it has not already been initialized. (Overrides ConfigurablePofContextEnsureInitialized.)
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetGenericTypeId	For user types that are not registered in the POF configuration used by this PofContext, determine if the user type can be serialized using POF, otherwise determine if the user type can be serialized using standard .NET BinaryFormatter.
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetInheritedUserTypeIdentifier	Helper method for determining the user type identifier associated with a given class that does not have a direct configured association. (Inherited from ConfigurablePofContext.)
	GetPofConfig	Obtain the ConfigurablePofContextPofConfig that represents the initialized state of the ConfigurablePofContext. (Inherited from ConfigurablePofContext.)
	GetPofSerializer	Return an IPofSerializer that can be used to serialize and deserialize an object of the specified user type to and from a POF stream. (Overrides ConfigurablePofContextGetPofSerializer(Int32).)
	GetSerializer	Returns serializer for user type specified by xmlType. (Inherited from ConfigurablePofContext.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	GetType(Int32)	Determine the type associated with the given user type identifier. (Overrides ConfigurablePofContextGetType(Int32).)
	GetTypeName	Determine the name of the type associated with a user type identifier. (Inherited from ConfigurablePofContext.)
	GetUserTypeIdentifier(Object)	Determine the user type identifier associated with the given object. (Inherited from ConfigurablePofContext.)
	GetUserTypeIdentifier(String)	Determine the user type identifier associated with the given type name. (Overrides ConfigurablePofContextGetUserTypeIdentifier(String).)
	GetUserTypeIdentifier(Type)	Determine the user type identifier associated with the given type. (Overrides ConfigurablePofContextGetUserTypeIdentifier(Type).)
	GetUserTypeIdentifierInternal(String)	Determine the user type identifier associated with the given type name. (Inherited from ConfigurablePofContext.)
	GetUserTypeIdentifierInternal(Type)	Determine the user type identifier associated with the given type. (Inherited from ConfigurablePofContext.)
	Initialize	Bind the ConfigurablePofContext to a URI of the configuration file, resolving all type names, etc. (Inherited from ConfigurablePofContext.)
	IsUserType(Object)	Determine if the given object is of a user type known to this IPofContext. (Inherited from ConfigurablePofContext.)
	IsUserType(String)	Determine if the type with the given name is a user type known to this IPofContext. (Overrides ConfigurablePofContextIsUserType(String).)
	IsUserType(Type)	Determine if the given type is a user type known to this IPofContext. (Overrides ConfigurablePofContextIsUserType(Type).)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ResolveType	Returns Type specified by xmlType with configuration information. (Inherited from ConfigurablePofContext.)
	Serialize	Serialize an object to a stream by writing its state using the specified DataWriter object. (Inherited from ConfigurablePofContext.)
	ThrowException	Assemble and throw an informative exception based on the passed details. (Inherited from ConfigurablePofContext.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Fields

	Name	Description
	TYPE_PORTABLE	The type identifier for objects that implement the PortableObject interface.
	TYPE_SERIALIZABLE	The type identifier for .NET Serializable objects.

Top

Remarks

Important note: this class is meant to be used only during application design time and replaced with the ConfigurablePofContext for production deployments as it has the following limitations:

SafeConfigurablePofContext is supported only for .NET clients;
Its performance is less optimal than of the ConfigurablePofContext;
The serialized form produced by the SafeConfigurablePofContext will not be recognized by POF aware ValueExtractors.

For user types that have been explicitly configured, this IPofContext behaves identically to the ConfigurablePofContext.

Reference

Tangosol.IO.Pof Namespace