XObjectFactoryDefault Class Reference

This class handles the creation of XObjects and manages their lifetime. More...

Inheritance diagram for XObjectFactoryDefault:

List of all members.

Public Types

• enum {
    eDefaultXStringBlockSize = 10, eDefaultXNumberBlockSize = 10, eDefaultXNodeSetBlockSize = 10, eDefaultXNodeSetNodeProxyBlockSize = 5,
    eXNumberCacheMax = 40, eXNodeSetCacheMax = 40, eXStringCacheMax = 40, eXResultTreeFragCacheMax = 40
  }
• typedef
  XNodeSetAllocator::size_type size_type
• typedef XalanVector< XObject * > XObjectCollectionType
• typedef XalanVector< XNumber * > XNumberCacheType
• typedef XalanVector< XNodeSet * > XNodeSetCacheType
• typedef XalanVector< XString * > XStringCacheType

Public Member Functions

• XObjectFactoryDefault (MemoryManagerType &theManager XALAN_DEFAULT_MEMMGR, size_type theXStringBlockSize=eDefaultXStringBlockSize, size_type theXNumberBlockSize=eDefaultXNumberBlockSize, size_type theXNodeSetBlockSize=eDefaultXNodeSetBlockSize, size_type theXNodeSetNodeProxyBlockSize=eDefaultXNodeSetNodeProxyBlockSize)

  Construct a factory for creating XObjects.
  

• virtual ~XObjectFactoryDefault ()
• MemoryManagerType & getMemoryManager ()
• virtual void reset ()

  Reset the instance.
  

• virtual const XObjectPtr createBoolean (bool theValue)

  Create a boolean XObject from a boolean value.
  

• virtual const XObjectPtr createNodeSet (BorrowReturnMutableNodeRefList &theValue)

  Create a node set XObject from a node list.
  

• virtual const XObjectPtr createNodeSet (XalanNode *theValue)

  Create a node set XObject from a node.
  

• virtual const XObjectPtr createNull ()

  Create a null XObject.
  

• virtual const XObjectPtr createNumber (double theValue)

  Create a numeric XObject from a number.
  

• virtual const XObjectPtr createNumber (const XToken &theValue)

  Create a numeric XObject from an XToken.
  

• virtual const XObjectPtr createString (const XalanDOMString &theValue)

  Create a string XObject from a string.
  

• virtual const XObjectPtr createString (const XalanDOMChar *theValue)

  Create a string XObject from a null-terminated array of characters.
  

• virtual const XObjectPtr createString (const XalanDOMChar *theValue, unsigned int theLength)

  Create a string XObject from an array of characters.
  

• virtual const XObjectPtr createString (const XToken &theValue)

  Create a string XObject from an XToken.
  

• virtual const XObjectPtr createStringReference (const XalanDOMString &theValue)

  Create a string XObject from a string.
  

• virtual const XObjectPtr createStringAdapter (const XObjectPtr &theValue)

  Create a string XObject that will adapt another XObject to behave like a string.
  

• virtual const XObjectPtr createString (GetAndReleaseCachedString &theValue)

  Create a string XObject from a cached XalanDOMString,.
  

• virtual const XObjectPtr createUnknown (const XalanDOMString &theValue)

  Create an "unknown" XObject from a string.
  

Static Public Member Functions

• static XObjectFactoryDefault * create (MemoryManagerType &theManager, size_type theXStringBlockSize=eDefaultXStringBlockSize, size_type theXNumberBlockSize=eDefaultXNumberBlockSize, size_type theXNodeSetBlockSize=eDefaultXNodeSetBlockSize, size_type theXNodeSetNodeProxyBlockSize=eDefaultXNodeSetNodeProxyBlockSize)

Protected Member Functions

• virtual bool doReturnObject (XObject *theXObject, bool fInReset=false)

  Return an XObject to the factory.
  

---

Detailed Description

This class handles the creation of XObjects and manages their lifetime.

---

Member Typedef Documentation

typedef XNodeSetAllocator::size_type XObjectFactoryDefault::size_type

typedef XalanVector<XNodeSet*> XObjectFactoryDefault::XNodeSetCacheType

typedef XalanVector<XNumber*> XObjectFactoryDefault::XNumberCacheType

typedef XalanVector<XObject*> XObjectFactoryDefault::XObjectCollectionType

typedef XalanVector<XString*> XObjectFactoryDefault::XStringCacheType

---

Member Enumeration Documentation

anonymous enum

Enumerator:

eDefaultXStringBlockSize
eDefaultXNumberBlockSize
eDefaultXNodeSetBlockSize
eDefaultXNodeSetNodeProxyBlockSize
eXNumberCacheMax
eXNodeSetCacheMax
eXStringCacheMax
eXResultTreeFragCacheMax

---

Constructor & Destructor Documentation

XObjectFactoryDefault::XObjectFactoryDefault	(	MemoryManagerType &theManager	XALAN_DEFAULT_MEMMGR,
		size_type	theXStringBlockSize = eDefaultXStringBlockSize,
		size_type	theXNumberBlockSize = eDefaultXNumberBlockSize,
		size_type	theXNodeSetBlockSize = eDefaultXNodeSetBlockSize,
		size_type	theXNodeSetNodeProxyBlockSize = eDefaultXNodeSetNodeProxyBlockSize
	)		[explicit]

Construct a factory for creating XObjects.

Parameters:

theXStringBlockSize	allocation block size
theXNumberBlockSize	allocation block size
theXNodeSetBlockSize	allocation block size

virtual XObjectFactoryDefault::~XObjectFactoryDefault

(

)

[virtual]

---

Member Function Documentation

static XObjectFactoryDefault* XObjectFactoryDefault::create	(	MemoryManagerType &	theManager,
		size_type	theXStringBlockSize = eDefaultXStringBlockSize,
		size_type	theXNumberBlockSize = eDefaultXNumberBlockSize,
		size_type	theXNodeSetBlockSize = eDefaultXNodeSetBlockSize,
		size_type	theXNodeSetNodeProxyBlockSize = eDefaultXNodeSetNodeProxyBlockSize
	)		[static]

virtual const XObjectPtr XObjectFactoryDefault::createBoolean

(

bool

theValue

)

[virtual]

Create a boolean XObject from a boolean value.

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createNodeSet

(

BorrowReturnMutableNodeRefList &

theValue

)

[virtual]

Create a node set XObject from a node list.

Parameters:

theValue

value used to create object. theValue will be owned by the new XObject.

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createNodeSet

(

XalanNode *

theValue

)

[virtual]

Create a node set XObject from a node.

Parameters:

theNOde

value used to create object.

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createNull

(

)

[virtual]

Create a null XObject.

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createNumber

(

double

theValue

)

[virtual]

Create a numeric XObject from a number.

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createNumber

(

const XToken &

theValue

)

[virtual]

Create a numeric XObject from an XToken.

The XToken instance must be inexistence for the lifetime of the object.

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createString

(

GetAndReleaseCachedString &

theValue

)

[virtual]

Create a string XObject from a cached XalanDOMString,.

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createString

(

const XalanDOMString &

theValue

)

[virtual]

Create a string XObject from a string.

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createString

(

const XalanDOMChar *

theValue

)

[virtual]

Create a string XObject from a null-terminated array of characters.

Parameters:

theValue

a pointer to the array

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createString	(	const XalanDOMChar *	theValue,
		unsigned int	theLength
	)		[virtual]

Create a string XObject from an array of characters.

Parameters:

theValue

a pointer to the array theLength the length of the array

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createString

(

const XToken &

theValue

)

[virtual]

Create a string XObject from an XToken.

The XToken instance must be inexistence for the lifetime of the object.

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createStringAdapter

(

const XObjectPtr &

theValue

)

[virtual]

Create a string XObject that will adapt another XObject to behave like a string.

The XObject holds a reference to the other XObject.

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createStringReference

(

const XalanDOMString &

theValue

)

[virtual]

Create a string XObject from a string.

The XObject will hold a reference to the supplied string, so the string must be in scope for the lifetime of the instance

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual const XObjectPtr XObjectFactoryDefault::createUnknown

(

const XalanDOMString &

theValue

)

[virtual]

Create an "unknown" XObject from a string.

Parameters:

theValue

value used to create object

Returns:

pointer to new object

Implements XObjectFactory.

virtual bool XObjectFactoryDefault::doReturnObject	(	XObject *	theXObject,
		bool	fInReset = false
	)		[protected, virtual]

Return an XObject to the factory.

Parameters:

theXObject	XObject to be returned
fInReset	true when called during reset().

Implements XObjectFactory.

MemoryManagerType& XObjectFactoryDefault::getMemoryManager

(

)

Reimplemented from XObjectFactory.

virtual void XObjectFactoryDefault::reset

(

)

[virtual]

Reset the instance.

This invalidates all existing instances created with this XObjectFactory.

Implements XObjectFactory.

---

The documentation for this class was generated from the following file:

• XObjectFactoryDefault.hpp