ILIAS  Release_4_4_x_branch Revision 61816
 All Data Structures Namespaces Files Functions Variables Groups Pages
Public Member Functions | Data Fields
ilBMFParser Class Reference
+ Inheritance diagram for ilBMFParser:
+ Collaboration diagram for ilBMFParser:

Public Member Functions

 ilBMFParser (&$xml, $encoding=SOAP_DEFAULT_ENCODING, $attachments=null)
 ilBMFParser constructor
 domulti ($d, &$ar, &$r, &$v, $ad=0)
 domulti recurse to build a multi-dim array, used by buildResponse
& buildResponse ($pos)
 buildResponse loop through msg, building response structures
 startElement ($parser, $name, $attrs)
 startElement start-element handler used with xml parser
 endElement ($parser, $name)
 endElement end-element handler used with xml parser
 characterData ($parser, $data)
 characterData element content handler used with xml parser
& getResponse ()
 Returns an array of responses.
& getHeaders ()
 Returns an array of header responses.
 decodeEntities ($text)
 decodeEntities
- Public Member Functions inherited from ilBMFBase
 ilBMFBase ($faultcode= 'Client')
 Constructor.
 _resetNamespaces ()
 _setSchemaVersion ($schemaVersion)
 Sets the schema version used in the SOAP message.
 _getNamespacePrefix ($ns)
 _getNamespaceForPrefix ($prefix)
 _isSoapValue (&$value)
 _serializeValue (&$value, $name= '', $type=false, $elNamespace=NULL, $typeNamespace=NULL, $options=array(), $attributes=array(), $artype='', $OBJTypeNS=array())
 _getType (&$value)
 Converts a PHP type to a SOAP type.
 _multiArrayType (&$value, &$type, &$size, &$xml)
 _isBase64 (&$value)
 Returns whether a string is base64 encoded data.
 _isBase64Type ($type)
 Returns whether a type is a base64 type.
 _isHash (&$a)
 Returns whether an array is a hash.
 _un_htmlentities ($string)
& _decode (&$soapval)
 _makeEnvelope (&$method, &$headers, $encoding=SOAP_DEFAULT_ENCODING, $options=array())
 Creates the SOAP envelope with the SOAP envelop data.
 _makeMimeMessage (&$xml, $encoding=SOAP_DEFAULT_ENCODING)
 _makeDIMEMessage ($xml)
 _decodeMimeMessage (&$data, &$headers, &$attachments)
 _decodeDIMEMessage (&$data, &$headers, &$attachments)
 __set_type_translation ($type, $class=null)
- Public Member Functions inherited from ilBMFBase_Object
 ilBMFBase_Object ($faultcode= 'Client')
 Constructor.
& _raiseSoapFault ($str, $detail= '', $actorURI= '', $code=null, $mode=null, $options=null, $skipmsg=false)
 Raises a SOAP error.
 __isfault ()
& __getfault ()
 _debug ($string)
 Adds a string to the debug data.
- Public Member Functions inherited from PEAR
 PEAR ($error_class=null)
 Constructor.
 _PEAR ()
 Destructor (the emulated type of...).
& getStaticProperty ($class, $var)
 If you have a class that's mostly/entirely static, and you need static properties, you can use this method to simulate them.
 registerShutdownFunc ($func, $args=array())
 Use this function to register a shutdown method for static classes.
 isError ($data, $code=null)
 Tell whether a value is a PEAR error.
 setErrorHandling ($mode=null, $options=null)
 Sets how errors generated by this object should be handled.
 expectError ($code= '*')
 This method is used to tell which errors you expect to get.
 popExpect ()
 This method pops one element off the expected error codes stack.
 _checkDelExpect ($error_code)
 This method checks unsets an error code if available.
 delExpect ($error_code)
 This method deletes all occurences of the specified element from the expected error codes stack.
& raiseError ($message=null, $code=null, $mode=null, $options=null, $userinfo=null, $error_class=null, $skipmsg=false)
 This method is a wrapper that returns an instance of the configured error class with this object's default error handling applied.
& throwError ($message=null, $code=null, $userinfo=null)
 Simpler form of raiseError with fewer options.
 staticPushErrorHandling ($mode, $options=null)
 staticPopErrorHandling ()
 pushErrorHandling ($mode, $options=null)
 Push a new error handler on top of the error handler options stack.
 popErrorHandling ()
 Pop the last error handler used.
 loadExtension ($ext)
 OS independant PHP extension load.

Data Fields

 $status = ''
 $position = 0
 $pos_stat = 0
 $depth = 0
 $default_namespace = ''
 $message = array()
 $depth_array = array()
 $previous_element = ''
 $soapresponse = null
 $soapheaders = null
 $parent = 0
 $root_struct_name = array()
 $header_struct_name = array()
 $curent_root_struct_name = ''
 $entities = array ( '&' => '&amp;', '<' => '&lt;', '>' => '&gt;', "'" => '&apos;', '"' => '&quot;' )
 $root_struct = array()
 $header_struct = array()
 $curent_root_struct = 0
 $references = array()
 $need_references = array()
 $XMLSchemaVersion
 $bodyDepth
- Data Fields inherited from ilBMFBase
 $_XMLSchema
 $_XMLSchemaVersion = 'http://www.w3.org/2001/XMLSchema'
 $_typemap
 $_defaultObjectClassname = 'stdClass'
 Default class name to use for decoded response objects.
 $_namespaces
 $_namespace
 $_xmlEntities
 $_doconversion = false
 $__attachments = array()
 $_wsdl = null
 $_section5 = true
 True if we use section 5 encoding, or false if this is literal.
 $_auto_translation = false
 $_type_translation = array()
- Data Fields inherited from ilBMFBase_Object
 $_debug_flag = false
 Store debugging information in $_debug_data?
 $_debug_data = ''
 String containing debugging information if $_debug_flag is true.
 $_encodings = array('ISO-8859-1', 'US-ASCII', 'UTF-8')
 Supported encodings, limited by XML extension.
 $_myfaultcode = ''
 Fault code.
 $fault = null
 Recent PEAR_Error object.
- Data Fields inherited from PEAR
 $_debug = false
 $_default_error_mode = null
 $_default_error_options = null
 $_default_error_handler = ''
 $_error_class = 'PEAR_Error'
 $_expected_errors = array()

Detailed Description

Definition at line 40 of file class.ilBMFParser.php.

Member Function Documentation

& ilBMFParser::buildResponse (   $pos)

buildResponse loop through msg, building response structures

Parameters
intposition
Returns
ilBMFValue private

Definition at line 137 of file class.ilBMFParser.php.

References domulti().

Referenced by getHeaders(), and getResponse().

{
$response = null;
if (isset($this->message[$pos]['children'])) {
$children = explode('|', $this->message[$pos]['children']);
foreach ($children as $c => $child_pos) {
if ($this->message[$child_pos]['type'] != null) {
$response[] =& $this->buildResponse($child_pos);
}
}
if (array_key_exists('arraySize', $this->message[$pos])) {
$ardepth = count($this->message[$pos]['arraySize']);
if ($ardepth > 1) {
$ar = array_pad(array(), $ardepth, 0);
if (array_key_exists('arrayOffset', $this->message[$pos])) {
for ($i = 0; $i < $ardepth; $i++) {
$ar[$i] += $this->message[$pos]['arrayOffset'][$i];
}
}
$elc = count($response);
for ($i = 0; $i < $elc; $i++) {
// recurse to build a multi-dimensional array
$this->domulti($ardepth, $ar, $newresp, $response[$i]);
// increment our array pointers
$ad = $ardepth - 1;
$ar[$ad]++;
while ($ad > 0 && $ar[$ad] >= $this->message[$pos]['arraySize'][$ad]) {
$ar[$ad] = 0;
$ad--;
$ar[$ad]++;
}
}
$response = $newresp;
} elseif (isset($this->message[$pos]['arrayOffset']) &&
$this->message[$pos]['arrayOffset'][0] > 0) {
// check for padding
$pad = $this->message[$pos]['arrayOffset'][0] + count($response) * -1;
$response = array_pad($response, $pad, null);
}
}
}
// Build attributes.
$attrs = array();
foreach ($this->message[$pos]['attrs'] as $atn => $atv) {
if (!strstr($atn, 'xmlns') &&
!strpos($atn, ':')) {
$attrs[$atn] = $atv;
}
}
// Add current node's value.
if ($response) {
$nqn =& new Qname($this->message[$pos]['name'], $this->message[$pos]['namespace']);
$tqn =& new Qname($this->message[$pos]['type'], $this->message[$pos]['type_namespace']);
$response =& new ilBMFValue($nqn->fqn(), $tqn->fqn(), $response, $attrs);
if (isset($this->message[$pos]['arrayType'])) {
$response->arrayType = $this->message[$pos]['arrayType'];
}
} else {
$nqn =& new Qname($this->message[$pos]['name'], $this->message[$pos]['namespace']);
$tqn =& new Qname($this->message[$pos]['type'], $this->message[$pos]['type_namespace']);
$response =& new ilBMFValue($nqn->fqn(), $tqn->fqn(), $this->message[$pos]['cdata'], $attrs);
}
// handle header attribute that we need
if (array_key_exists('actor', $this->message[$pos])) {
$response->actor = $this->message[$pos]['actor'];
}
if (array_key_exists('mustUnderstand', $this->message[$pos])) {
$response->mustunderstand = $this->message[$pos]['mustUnderstand'];
}
return $response;
}

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

ilBMFParser::characterData (   $parser,
  $data 
)

characterData element content handler used with xml parser

private

Definition at line 453 of file class.ilBMFParser.php.

References $depth.

{
$pos = $this->depth_array[$this->depth];
if (isset($this->message[$pos]['cdata'])) {
$this->message[$pos]['cdata'] .= $data;
} else {
$this->message[$pos]['cdata'] = $data;
}
}
ilBMFParser::decodeEntities (   $text)

decodeEntities

removes entities from text

Parameters
string
Returns
string private

Definition at line 512 of file class.ilBMFParser.php.

{
$trans_tbl = array_flip($this->entities);
return strtr($text, $trans_tbl);
}
ilBMFParser::domulti (   $d,
&  $ar,
&  $r,
&  $v,
  $ad = 0 
)

domulti recurse to build a multi-dim array, used by buildResponse

private

Definition at line 120 of file class.ilBMFParser.php.

References $d.

Referenced by buildResponse().

{
if ($d) {
$this->domulti($d-1, $ar, $r[$ar[$ad]], $v, $ad+1);
} else {
$r = $v;
}
}

+ Here is the caller graph for this function:

ilBMFParser::endElement (   $parser,
  $name 
)

endElement end-element handler used with xml parser

private

Definition at line 388 of file class.ilBMFParser.php.

References $depth, and $parent.

{
// Position of current element is equal to the last value left
// in depth_array for my depth.
$pos = $this->depth_array[$this->depth];
// Bring depth down a notch.
$this->depth--;
$qname =& new QName($name);
// Get type if not explicitly declared in an xsi:type attribute.
// XXX check on integrating wsdl validation here
if ($this->message[$pos]['type'] == '') {
if (isset($this->message[$pos]['children'])) {
/* this is slow, need to look at some faster method
$children = explode('|', $this->message[$pos]['children']);
if (count($children) > 2 &&
$this->message[$children[1]]['name'] == $this->message[$children[2]]['name']) {
$this->message[$pos]['type'] = 'Array';
} else {
$this->message[$pos]['type'] = 'Struct';
}*/
$this->message[$pos]['type'] = 'Struct';
} else {
$parent = $this->message[$pos]['parent'];
if ($this->message[$parent]['type'] == 'Array' &&
array_key_exists('arrayType', $this->message[$parent])) {
$this->message[$pos]['type'] = $this->message[$parent]['arrayType'];
} else {
$this->message[$pos]['type'] = 'string';
}
}
}
// If tag we are currently closing is the method wrapper.
if ($pos == $this->curent_root_struct) {
$this->status = 'body';
} elseif ($qname->name == 'Body' || $qname->name == 'Header') {
$this->status = 'envelope';
}
// Set parent back to my parent.
$this->parent = $this->message[$pos]['parent'];
// Handle any reverse references now.
$idref = $this->message[$pos]['id'];
if ($idref != '' && array_key_exists($idref, $this->need_references)) {
foreach ($this->need_references[$idref] as $ref_pos) {
// XXX is this stuff there already?
$this->message[$ref_pos]['children'] = &$this->message[$pos]['children'];
$this->message[$ref_pos]['cdata'] = &$this->message[$pos]['cdata'];
$this->message[$ref_pos]['type'] = &$this->message[$pos]['type'];
$this->message[$ref_pos]['arraySize'] = &$this->message[$pos]['arraySize'];
$this->message[$ref_pos]['arrayType'] = &$this->message[$pos]['arrayType'];
}
}
}
& ilBMFParser::getHeaders ( )

Returns an array of header responses.

After parsing a SOAP message, use this to get the response.

Returns
array public

Definition at line 490 of file class.ilBMFParser.php.

References buildResponse().

{
if (isset($this->header_struct[0]) &&
$this->header_struct[0]) {
$response = &$this->buildResponse($this->header_struct[0]);
} else {
// We don't fault if there are no headers; that can be handled by
// the application if necessary.
$response = null;
}
return $response;
}

+ Here is the call graph for this function:

& ilBMFParser::getResponse ( )

Returns an array of responses.

After parsing a SOAP message, use this to get the response.

Returns
array public

Definition at line 471 of file class.ilBMFParser.php.

References ilBMFBase_Object\_raiseSoapFault(), and buildResponse().

{
if (isset($this->root_struct[0]) &&
$this->root_struct[0]) {
$response =& $this->buildResponse($this->root_struct[0]);
} else {
$response =& $this->_raiseSoapFault("couldn't build response");
}
return $response;
}

+ Here is the call graph for this function:

ilBMFParser::ilBMFParser ( &  $xml,
  $encoding = SOAP_DEFAULT_ENCODING,
  $attachments = null 
)

ilBMFParser constructor

Parameters
stringxml content
stringxml character encoding, defaults to 'UTF-8'

Definition at line 71 of file class.ilBMFParser.php.

References ilBMFBase_Object\_raiseSoapFault(), ilBMFBase\_setSchemaVersion(), ilBMFBase\ilBMFBase(), and SOAP_XML_SCHEMA_VERSION.

{
parent::ilBMFBase('Parser');
$this->_setSchemaVersion(SOAP_XML_SCHEMA_VERSION);
$this->attachments = $attachments;
// Check the xml tag for encoding.
if (preg_match('/<\?xml[^>]+encoding\s*?=\s*?(\'([^\']*)\'|"([^"]*)")[^>]*?[\?]>/', $xml, $m)) {
$encoding = strtoupper($m[2] ? $m[2] : $m[3]);
}
// Determines where in the message we are
// (envelope,header,body,method). Check whether content has
// been read.
if (!empty($xml)) {
// Prepare the xml parser.
$parser = xml_parser_create($encoding);
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_set_object($parser, $this);
xml_set_element_handler($parser, 'startElement', 'endElement');
xml_set_character_data_handler($parser, 'characterData');
// Some lame soap implementations add null bytes at the
// end of the soap stream, and expat choaks on that.
if ($xml[strlen($xml) - 1] == 0) {
$xml = trim($xml);
}
// Parse the XML file.
if (!xml_parse($parser, $xml, true)) {
$err = sprintf('XML error on line %d col %d byte %d %s',
xml_get_current_line_number($parser),
xml_get_current_column_number($parser),
xml_get_current_byte_index($parser),
xml_error_string(xml_get_error_code($parser)));
$this->_raiseSoapFault($err,htmlspecialchars($xml));
}
xml_parser_free($parser);
}
}

+ Here is the call graph for this function:

ilBMFParser::startElement (   $parser,
  $name,
  $attrs 
)

startElement start-element handler used with xml parser

private

Definition at line 221 of file class.ilBMFParser.php.

References $default_namespace, $depth, $namespace, $parent, $status, ilBMFBase\_getNamespaceForPrefix(), ilBMFBase\_getNamespacePrefix(), and ilBMFBase\_setSchemaVersion().

{
// position in a total number of elements, starting from 0
// update class level pos
$pos = $this->position++;
// and set mine
$this->message[$pos] = array();
$this->message[$pos]['type'] = '';
$this->message[$pos]['type_namespace'] = '';
$this->message[$pos]['cdata'] = '';
$this->message[$pos]['pos'] = $pos;
$this->message[$pos]['id'] = '';
// parent/child/depth determinations
// depth = how many levels removed from root?
// set mine as current global depth and increment global depth value
$this->message[$pos]['depth'] = $this->depth++;
// else add self as child to whoever the current parent is
if ($pos != 0) {
if (isset($this->message[$this->parent]['children']))
$this->message[$this->parent]['children'] .= "|$pos";
else
$this->message[$this->parent]['children'] = $pos;
}
// set my parent
$this->message[$pos]['parent'] = $this->parent;
// set self as current value for this depth
$this->depth_array[$this->depth] = $pos;
// set self as current parent
$this->parent = $pos;
$qname =& new QName($name);
// set status
if (strcasecmp('envelope', $qname->name) == 0) {
$this->status = 'envelope';
} elseif (strcasecmp('header', $qname->name) == 0) {
$this->status = 'header';
$this->header_struct_name[] = $this->curent_root_struct_name = $qname->name;
$this->header_struct[] = $this->curent_root_struct = $pos;
$this->message[$pos]['type'] = 'Struct';
} elseif (strcasecmp('body', $qname->name) == 0) {
$this->status = 'body';
$this->bodyDepth = $this->depth;
// Set method
} elseif ($this->status == 'body') {
// Is this element allowed to be a root?
// XXX this needs to be optimized, we loop through attrs twice now.
$can_root = $this->depth == $this->bodyDepth + 1;
if ($can_root) {
foreach ($attrs as $key => $value) {
if (stristr($key, ':root') && !$value) {
$can_root = FALSE;
}
}
}
if ($can_root) {
$this->status = 'method';
$this->root_struct_name[] = $this->curent_root_struct_name = $qname->name;
$this->root_struct[] = $this->curent_root_struct = $pos;
$this->message[$pos]['type'] = 'Struct';
}
}
// Set my status.
$this->message[$pos]['status'] = $this->status;
// Set name.
$this->message[$pos]['name'] = htmlspecialchars($qname->name);
// Set attributes.
$this->message[$pos]['attrs'] = $attrs;
// Loop through attributes, logging ns and type declarations.
foreach ($attrs as $key => $value) {
// If ns declarations, add to class level array of valid
// namespaces.
$kqn =& new QName($key);
if ($kqn->ns == 'xmlns') {
$prefix = $kqn->name;
if (in_array($value, $this->_XMLSchema)) {
$this->_setSchemaVersion($value);
}
$this->_namespaces[$value] = $prefix;
// Set method namespace.
} elseif ($key == 'xmlns') {
$qname->ns = $this->_getNamespacePrefix($value);
$qname->namespace = $value;
} elseif ($kqn->name == 'actor') {
$this->message[$pos]['actor'] = $value;
} elseif ($kqn->name == 'mustUnderstand') {
$this->message[$pos]['mustUnderstand'] = $value;
// If it's a type declaration, set type.
} elseif ($kqn->name == 'type') {
$vqn =& new QName($value);
$this->message[$pos]['type'] = $vqn->name;
$this->message[$pos]['type_namespace'] = $this->_getNamespaceForPrefix($vqn->ns);
// Should do something here with the namespace of
// specified type?
} elseif ($kqn->name == 'arrayType') {
$vqn =& new QName($value);
$this->message[$pos]['type'] = 'Array';
if (isset($vqn->arraySize)) {
$this->message[$pos]['arraySize'] = $vqn->arraySize;
}
$this->message[$pos]['arrayType'] = $vqn->name;
} elseif ($kqn->name == 'offset') {
$this->message[$pos]['arrayOffset'] = split(',', substr($value, 1, strlen($value) - 2));
} elseif ($kqn->name == 'id') {
// Save id to reference array.
$this->references[$value] = $pos;
$this->message[$pos]['id'] = $value;
} elseif ($kqn->name == 'href') {
if ($value[0] == '#') {
$ref = substr($value, 1);
if (isset($this->references[$ref])) {
// cdata, type, inval.
$ref_pos = $this->references[$ref];
$this->message[$pos]['children'] = &$this->message[$ref_pos]['children'];
$this->message[$pos]['cdata'] = &$this->message[$ref_pos]['cdata'];
$this->message[$pos]['type'] = &$this->message[$ref_pos]['type'];
$this->message[$pos]['arraySize'] = &$this->message[$ref_pos]['arraySize'];
$this->message[$pos]['arrayType'] = &$this->message[$ref_pos]['arrayType'];
} else {
// Reverse reference, store in 'need reference'.
if (!isset($this->need_references[$ref])) {
$this->need_references[$ref] = array();
}
$this->need_references[$ref][] = $pos;
}
} elseif (isset($this->attachments[$value])) {
$this->message[$pos]['cdata'] = $this->attachments[$value];
}
}
}
// See if namespace is defined in tag.
if (array_key_exists('xmlns:' . $qname->ns, $attrs)) {
$namespace = $attrs['xmlns:' . $qname->ns];
} elseif ($qname->ns && !$qname->namespace) {
$namespace = $this->_getNamespaceForPrefix($qname->ns);
} else {
// Get namespace.
$namespace = $qname->namespace ? $qname->namespace : $this->default_namespace;
}
$this->message[$pos]['namespace'] = $namespace;
$this->default_namespace = $namespace;
}

+ Here is the call graph for this function:

Field Documentation

ilBMFParser::$bodyDepth

Definition at line 63 of file class.ilBMFParser.php.

ilBMFParser::$curent_root_struct = 0

Definition at line 59 of file class.ilBMFParser.php.

ilBMFParser::$curent_root_struct_name = ''

Definition at line 55 of file class.ilBMFParser.php.

ilBMFParser::$default_namespace = ''

Definition at line 46 of file class.ilBMFParser.php.

Referenced by startElement().

ilBMFParser::$depth = 0

Definition at line 45 of file class.ilBMFParser.php.

Referenced by characterData(), endElement(), and startElement().

ilBMFParser::$depth_array = array()

Definition at line 48 of file class.ilBMFParser.php.

ilBMFParser::$entities = array ( '&' => '&amp;', '<' => '&lt;', '>' => '&gt;', "'" => '&apos;', '"' => '&quot;' )

Definition at line 56 of file class.ilBMFParser.php.

ilBMFParser::$header_struct = array()

Definition at line 58 of file class.ilBMFParser.php.

ilBMFParser::$header_struct_name = array()

Definition at line 54 of file class.ilBMFParser.php.

ilBMFParser::$message = array()

Definition at line 47 of file class.ilBMFParser.php.

ilBMFParser::$need_references = array()

Definition at line 61 of file class.ilBMFParser.php.

ilBMFParser::$parent = 0

Definition at line 52 of file class.ilBMFParser.php.

Referenced by endElement(), and startElement().

ilBMFParser::$pos_stat = 0

Definition at line 44 of file class.ilBMFParser.php.

ilBMFParser::$position = 0

Definition at line 43 of file class.ilBMFParser.php.

ilBMFParser::$previous_element = ''

Definition at line 49 of file class.ilBMFParser.php.

ilBMFParser::$references = array()

Definition at line 60 of file class.ilBMFParser.php.

ilBMFParser::$root_struct = array()

Definition at line 57 of file class.ilBMFParser.php.

ilBMFParser::$root_struct_name = array()

Definition at line 53 of file class.ilBMFParser.php.

ilBMFParser::$soapheaders = null

Definition at line 51 of file class.ilBMFParser.php.

ilBMFParser::$soapresponse = null

Definition at line 50 of file class.ilBMFParser.php.

ilBMFParser::$status = ''

Definition at line 42 of file class.ilBMFParser.php.

Referenced by startElement().

ilBMFParser::$XMLSchemaVersion

Definition at line 62 of file class.ilBMFParser.php.

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