Class DAVPrincipal

Description

A class for things to do with a DAV Principal

Located in /inc/DAVPrincipal.php (line 18)

Principal
   |
   --DAVPrincipal
Variable Summary
 RFC3744: $_is_group
Method Summary
 boolean __construct ([mixed $parameters = null])
 void AsCollection ()
 string GetProperty ( $property_id)
 void GroupMemberSet ()
 void GroupMembership ()
 void InitialiseRecord (object $usr)
 boolean IsGroup ()
 void PrincipalProperty ( $tag,  $prop,  &$reply,  &$denied)
 void Privileges ()
 void PropertySearch ( $parameters)
 void ProxyFor (string $type)
 void ReadProxyGroup ()
 string RenderAsXML (array $properties,  &$reply, [boolean $props_only = false], reference $reply)
 void unique_tag ()
 void WriteProxyGroup ()
Variables
Methods
Constructor __construct (line 94)

Constructor

  • return: Whether we actually read data from the DB to initialise the record.
boolean __construct ([mixed $parameters = null])
  • mixed $parameters: If null, an empty Principal is created. If it is an integer then that ID is read (if possible). If it is an array then the Principal matching the supplied elements is read. If it is an object then it is expected to be a 'usr' record that was read elsewhere.

Redefinition of:
Principal::__construct()
Construct a new Principal object. The principal record will be retrieved from the database, or (if not found) initialised to a new record. You can test for whether the Principal exists by calling the Exists() method on the returned object.
addressbook_home_set (line 358)

Get the addressbook_home_set, as lazily as possible

void addressbook_home_set ()
AsCollection (line 419)

Returns a representation of the principal as a collection

void AsCollection ()
calendar_free_busy_set (line 381)

Get the calendar_free_busy_set, as lazily as possible

void calendar_free_busy_set ()
calendar_home_set (line 335)

Get the calendar_home_set, as lazily as possible

void calendar_home_set ()
FetchProxyGroups (line 193)

Split this out so we do it as infrequently as possible, given the cost.

void FetchProxyGroups ()
GetProperty (line 302)

Return an arbitrary property

  • return: The name of the arbitrary property
string GetProperty ( $property_id)
  • $property_id
GroupMemberSet (line 283)

Accessor for the group member set - the members of this group

void GroupMemberSet ()
GroupMembership (line 274)

Accessor for the group membership - the groups this principal is a member of

void GroupMembership ()
InitialiseRecord (line 143)

Initialise the Principal object from a $usr record from the DB.

void InitialiseRecord (object $usr)
  • object $usr: The usr record from the DB.
IsGroup (line 293)

Is this a group principal?

  • return: Whether this is a group principal
boolean IsGroup ()
PrincipalProperty (line 450)

Returns properties which are specific to this principal

void PrincipalProperty ( $tag,  $prop,  &$reply,  &$denied)
  • $tag
  • $prop
  • &$reply
  • &$denied
Privileges (line 403)

Return the privileges bits for the current session user to this resource

void Privileges ()
PropertySearch (line 443)
void PropertySearch ( $parameters)
  • $parameters
ProxyFor (line 264)

Accessor for read or write proxy

void ProxyFor (string $type)
  • string $type: read/write - which sort of proxy list is requested.
ReadProxyGroup (line 245)

Accessor for the read proxy group

void ReadProxyGroup ()
RenderAsXML (line 568)

Render XML for a single Principal (user) from the DB

  • return: An XML fragment with the requested properties for this principal
string RenderAsXML (array $properties,  &$reply, [boolean $props_only = false], reference $reply)
  • array $properties: The requested properties for this principal
  • reference $reply: A reference to the XMLDocument being used for the reply
  • boolean $props_only: Default false. If true will only return the fragment with the properties, not a full response fragment.
  • &$reply
unique_tag (line 323)

Returns the unique_tag (ETag or getctag) for this resource

  • access: public
void unique_tag ()
WriteProxyGroup (line 254)

Accessor for the write proxy group

void WriteProxyGroup ()

Inherited Methods

Inherited From Principal

 Principal::__construct()
 Principal::byEmail()
 Principal::cacheDelete()
 Principal::cacheFlush()
 Principal::Create()
 Principal::dav_name()
 Principal::default_calendar()
 Principal::email()
 Principal::Exists()
 Principal::FetchCollections()
 Principal::FetchDeadProperties()
 Principal::internal_url()
 Principal::principal_id()
 Principal::setUsername()
 Principal::unCache()
 Principal::Update()
 Principal::updateableFields()
 Principal::url()
 Principal::username()
 Principal::user_no()
 Principal::__get()
 Principal::__isset()

Documentation generated on Mon, 24 Oct 2011 20:09:27 +1300 by phpDocumentor 1.4.3