PTLib  Version 2.14.3
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
PHTTPCompositeField Class Reference

#include <httpform.h>

Inheritance diagram for PHTTPCompositeField:
Collaboration diagram for PHTTPCompositeField:

Public Member Functions

 PHTTPCompositeField (const char *name, const char *title=NULL, const char *help=NULL, bool includeHeaders=false)
 
virtual void SetName (const PString &name)
 Set the name for the field. More...
 
virtual const PHTTPFieldLocateName (const PString &name) const
 Locate the field naem, recusing down for composite fields. More...
 
virtual PHTTPFieldNewField () const
 Create a new field of the same class as the current field. More...
 
virtual void ExpandFieldNames (PString &text, PINDEX start, PINDEX &finish) const
 
virtual void GetHTMLTag (PHTML &html) const
 Convert the field to HTML form tag for inclusion into the HTTP page. More...
 
virtual PString GetHTMLInput (const PString &input) const
 Convert the field input to HTML for inclusion into the HTTP page. More...
 
virtual void GetHTMLHeading (PHTML &html) const
 Convert the field to HTML for inclusion into the HTTP page. More...
 
virtual PString GetValue (PBoolean dflt=false) const
 Get the string value of the field. More...
 
virtual void SetValue (const PString &newValue)
 Set the value of the field. More...
 
virtual bool LoadFromConfig (PConfig &cfg)
 Get the value of the PConfig to the sub-field. More...
 
virtual void SaveToConfig (PConfig &cfg) const
 Set the value of the sub-field into the PConfig. More...
 
virtual void GetAllNames (PStringArray &names) const
 Retrieve all the names in the field and subfields. More...
 
virtual void SetAllValues (const PStringToString &data)
 Set the value of the field in a list of fields. More...
 
virtual PBoolean ValidateAll (const PStringToString &data, PStringStream &msg) const
 Validate the new field value in a list before SetValue() is called. More...
 
virtual PINDEX GetSize () const
 Get the number of sub-fields in the composite field. More...
 
void Append (PHTTPField *fld)
 
PHTTPFieldoperator[] (PINDEX idx) const
 
void RemoveAt (PINDEX idx)
 
void RemoveAll ()
 
- Public Member Functions inherited from PHTTPField
 PHTTPField (const char *bname, const char *title, const char *help)
 
virtual Comparison Compare (const PObject &obj) const
 Compare the fields using the field names. More...
 
const PCaselessStringGetName () const
 Get the identifier name of the field. More...
 
const PCaselessStringGetBaseName () const
 Get the identifier name of the field. More...
 
const PStringGetTitle () const
 Get the title of the field. More...
 
const PStringGetHelp () const
 Get the title of the field. More...
 
void SetHelp (const PString &text)
 
void SetHelp (const PString &hotLinkURL, const PString &linkText)
 
void SetHelp (const PString &hotLinkURL, const PString &imageURL, const PString &imageText)
 
virtual PString GetHTMLSelect (const PString &selection) const
 Convert the field input to HTML for inclusion into the HTTP page. More...
 
virtual PBoolean Validated (const PString &newVal, PStringStream &msg) const
 Validate the new field value before SetValue() is called. More...
 
PBoolean NotYetInHTML () const
 
void SetInHTML ()
 
- Public Member Functions inherited from PObject
unsigned GetTraceContextIdentifier () const
 Get PTRACE context identifier. More...
 
void SetTraceContextIdentifier (unsigned id)
 
void GetTraceContextIdentifier (PObject &obj)
 
void GetTraceContextIdentifier (PObject *obj)
 
void SetTraceContextIdentifier (const PObject &obj)
 
void SetTraceContextIdentifier (const PObject *obj)
 
virtual ~PObject ()
 
virtual PObjectClone () const
 Create a copy of the class on the heap. More...
 
template<class CLS >
CLS * CloneAs () const
 As for Clone() but converts to specified type. More...
 
virtual PINDEX HashFunction () const
 This function yields a hash value required by the PDictionary class. More...
 
virtual Comparison CompareObjectMemoryDirect (const PObject &obj) const
 Determine the byte wise comparison of two objects. More...
 
bool operator== (const PObject &obj) const
 Compare the two objects. More...
 
bool operator!= (const PObject &obj) const
 Compare the two objects. More...
 
bool operator< (const PObject &obj) const
 Compare the two objects. More...
 
bool operator> (const PObject &obj) const
 Compare the two objects. More...
 
bool operator<= (const PObject &obj) const
 Compare the two objects. More...
 
bool operator>= (const PObject &obj) const
 Compare the two objects. More...
 
virtual const char * GetClass (unsigned ancestor=0) const
 Get the current dynamic type of the object instance. More...
 
PBoolean IsClass (const char *cls) const
 
virtual PBoolean InternalIsDescendant (const char *clsName) const
 Determine if the dynamic type of the current instance is a descendent of the specified class. More...
 
__inline const PObjectPTraceObjectInstance () const
 
virtual void PrintOn (ostream &strm) const
 Output the contents of the object to the stream. More...
 
virtual void ReadFrom (istream &strm)
 Input the contents of the object from the stream. More...
 

Protected Attributes

PHTTPFields fields
 
bool m_includeHeaders
 
- Protected Attributes inherited from PHTTPField
PCaselessString baseName
 
PCaselessString fullName
 
PString title
 
PString help
 
PBoolean notInHTML
 
- Protected Attributes inherited from PObject
unsigned m_traceContextIdentifier
 

Additional Inherited Members

- Public Types inherited from PObject
enum  Comparison { LessThan = -1, EqualTo = 0, GreaterThan = 1 }
 Result of the comparison operation performed by the Compare() function. More...
 
- Static Public Member Functions inherited from PObject
static Comparison InternalCompareObjectMemoryDirect (const PObject *obj1, const PObject *obj2, PINDEX size)
 Internal function caled from CompareObjectMemoryDirect() More...
 
static const char * Class ()
 Get the name of the class as a C string. More...
 
static __inline const PObjectPTraceObjectInstance (const char *)
 
static __inline const PObjectPTraceObjectInstance (const PObject *obj)
 
- Protected Member Functions inherited from PObject
 PObject ()
 Constructor for PObject, made protected so cannot ever create one on its own. More...
 
- Friends inherited from PObject

Constructor & Destructor Documentation

PHTTPCompositeField::PHTTPCompositeField ( const char *  name,
const char *  title = NULL,
const char *  help = NULL,
bool  includeHeaders = false 
)

Member Function Documentation

void PHTTPCompositeField::Append ( PHTTPField fld)
virtual void PHTTPCompositeField::ExpandFieldNames ( PString text,
PINDEX  start,
PINDEX &  finish 
) const
virtual

Reimplemented from PHTTPField.

Reimplemented in PHTTPFieldArray.

virtual void PHTTPCompositeField::GetAllNames ( PStringArray names) const
virtual

Retrieve all the names in the field and subfields.

Returns
Array of strings for each subfield.

Reimplemented from PHTTPField.

virtual void PHTTPCompositeField::GetHTMLHeading ( PHTML html) const
virtual

Convert the field to HTML for inclusion into the HTTP page.

Reimplemented from PHTTPField.

Reimplemented in PHTTPSubForm.

virtual PString PHTTPCompositeField::GetHTMLInput ( const PString input) const
virtual

Convert the field input to HTML for inclusion into the HTTP page.

Reimplemented from PHTTPField.

virtual void PHTTPCompositeField::GetHTMLTag ( PHTML html) const
virtual

Convert the field to HTML form tag for inclusion into the HTTP page.

Implements PHTTPField.

Reimplemented in PHTTPFieldArray, and PHTTPSubForm.

virtual PINDEX PHTTPCompositeField::GetSize ( ) const
virtual

Get the number of sub-fields in the composite field.

Note that this is the total including any composite sub-fields, ie, it is the size of the whole tree of primitive fields.

Returns
Returns field count.

Reimplemented in PHTTPFieldArray.

virtual PString PHTTPCompositeField::GetValue ( PBoolean  dflt = false) const
virtual

Get the string value of the field.

Returns
String for field value.

Implements PHTTPField.

virtual bool PHTTPCompositeField::LoadFromConfig ( PConfig cfg)
virtual

Get the value of the PConfig to the sub-field.

If the field is not composite then it always sets the value as for the non-indexed version.

Returns
true if no configuration set and a default should be used.

Reimplemented from PHTTPField.

Reimplemented in PHTTPFieldArray.

virtual const PHTTPField* PHTTPCompositeField::LocateName ( const PString name) const
virtual

Locate the field naem, recusing down for composite fields.

Returns
Pointer to located field, or NULL if not found.

Reimplemented from PHTTPField.

virtual PHTTPField* PHTTPCompositeField::NewField ( ) const
virtual

Create a new field of the same class as the current field.

Returns
New field object instance.

Implements PHTTPField.

Reimplemented in PHTTPFieldArray, and PHTTPSubForm.

PHTTPField& PHTTPCompositeField::operator[] ( PINDEX  idx) const
inline

References fields.

void PHTTPCompositeField::RemoveAll ( )
inline

References fields.

Referenced by PHTTPForm::RemoveAllFields().

void PHTTPCompositeField::RemoveAt ( PINDEX  idx)
inline

References fields.

virtual void PHTTPCompositeField::SaveToConfig ( PConfig cfg) const
virtual

Set the value of the sub-field into the PConfig.

If the field is not composite then it always sets the value as for the non-indexed version.

Reimplemented from PHTTPField.

Reimplemented in PHTTPFieldArray.

virtual void PHTTPCompositeField::SetAllValues ( const PStringToString data)
virtual

Set the value of the field in a list of fields.

Reimplemented from PHTTPField.

Reimplemented in PHTTPFieldArray.

virtual void PHTTPCompositeField::SetName ( const PString newName)
virtual

Set the name for the field.

Reimplemented from PHTTPField.

virtual void PHTTPCompositeField::SetValue ( const PString newValue)
virtual

Set the value of the field.

Implements PHTTPField.

virtual PBoolean PHTTPCompositeField::ValidateAll ( const PStringToString data,
PStringStream msg 
) const
virtual

Validate the new field value in a list before SetValue() is called.

Returns
PBoolean if the all the new field values are OK.

Reimplemented from PHTTPField.

Member Data Documentation

PHTTPFields PHTTPCompositeField::fields
protected

Referenced by operator[](), RemoveAll(), and RemoveAt().

bool PHTTPCompositeField::m_includeHeaders
protected

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