©
This document uses PHP Chinese website manual Release
(PHP 4, PHP 5 < 5.2.0, PECL hwapi SVN)
hw_api::object — Retrieve attribute information
$parameter
)This function retrieves the attribute information of an object of any version. It will not return the document content.
parameter
The parameter array contains the required elements 'objectIdentifier' and the optional elements 'attributeSelector' and 'version'.
The returned object is an instance of class HW_API_Object on success or HW_API_Error if an error occurred.
This simple example retrieves an object and checks for errors.
Example #1 Retrieve an object
<?php
function handle_error ( $error )
{
$reason = $error -> reason ( 0 );
echo "Type: <b>" ;
switch ( $reason -> type ()) {
case 0 :
echo "Error" ;
break;
case 1 :
echo "Warning" ;
break;
case 2 :
echo "Message" ;
break;
}
echo "</b><br />\n" ;
echo "Description: " . $reason -> description ( "en" ) . "<br />\n" ;
}
function list_attr ( $obj )
{
echo "<table>\n" ;
$count = $obj -> count ();
for ( $i = 0 ; $i < $count ; $i ++) {
$attr = $obj -> attribute ( $i );
printf ( "<tr><td align=\"right\" bgcolor=\"#c0c0c0\"><b>%s</b></td><td bgcolor=\"#F0F0F0\">%s</td></tr>\n" ,
$attr -> key (), $attr -> value ());
}
echo "</table>\n" ;
}
$hwapi = hwapi_hgcsp ( $g_config [ HOSTNAME ]);
$parms = array( "objectIdentifier" => "rootcollection" , "attributeSelector" =>array( "Title" , "Name" , "DocumentType" ));
$root = $hwapi -> object ( $parms );
if ( get_class ( $root ) == "HW_API_Error" ) {
handle_error ( $root );
exit;
}
list_attr ( $root );
?>