Abstract Class xPDOVehicle

Description

Represents an individual artifact within an xPDOTransport package.

Extend this abstract class to provide custom xPDOVehicle behavior for various kinds of artifacts (e.g. objects, xPDOObjects, files, database schemas, etc.).

  • abstract:

Located in /xpdo/transport/xpdovehicle.class.php (line 38)


	
			
Direct descendents
Class Description
 class xPDOFileVehicle Represents an individual file set within an xPDOTransport package.
 class xPDOObjectVehicle Represents an xPDOObject within an xPDOTransport package.
 class xPDOTransportVehicle Represents an xPDOTransport embedded within an xPDOTransport package.
Variable Summary
 mixed $class
 array $payload
Method Summary
 void get ( &$transport, [array $options = array ()], [array $element = null], xPDOTransport $transport)
 boolean install (xPDOTransport &$transport, array $options)
 void put ( &$transport, mixed &$object, [array $attributes = array ()], xPDOTransport $transport)
 array register (xPDOTransport &$transport)
 boolean resolve (xPDOTransport &$transport, mixed &$object, [array $options = array ()])
 boolean store (xPDOTransport &$transport)
 void uninstall (xPDOTransport &$transport, array $options)
 boolean validate (xPDOTransport &$transport, xPDOObject &$object, [array $options = array ()])
 void _compilePayload (xPDOTransport &$transport)
Variables
mixed $class = 'xPDOVehicle' (line 45)
  • access: public

Redefined in descendants as:
array $payload = array () (line 43)

Represents the artifact and related attributes stored in the vehicle.

  • access: public
Methods
get (line 89)

Retrieve an artifact represented in this vehicle.

By default, this method simply returns the raw payload merged with the provided options, but you can optionally provide a payload element specifically on which to operate as well as override the method in derivatives to further transform the returned artifact.

  • access: public
void get ( &$transport, [array $options = array ()], [array $element = null], xPDOTransport $transport)
  • xPDOTransport $transport: The transport package containing this vehicle.
  • array $options: Options that apply to the artifact or retrieval process.
  • array $element: An optional payload element representing a specific part of the artifact to operate on. If not specified, the root element of the payload is used.
  • &$transport

Redefined in descendants as:
install (line 106)

Install the vehicle artifact into a transport host.

  • return: True if the installation of the vehicle artifact was successful.
  • abstract:
  • access: public
boolean install (xPDOTransport &$transport, array $options)
  • xPDOTransport &$transport: A reference to the transport.
  • array $options: An array of options for altering the installation of the artifact.

Redefined in descendants as:
put (line 292)

Put an artifact representation into this vehicle.

  • access: public
void put ( &$transport, mixed &$object, [array $attributes = array ()], xPDOTransport $transport)
  • xPDOTransport $transport: The transport package hosting the vehicle.
  • mixed &$object: A reference to the artifact this vehicle will represent.
  • array $attributes: Additional attributes represented in the vehicle.
  • &$transport

Redefined in descendants as:
register (line 55)

Build a manifest entry to be registered in a transport for this vehicle.

  • return: An array of vehicle attributes that will be registered into an xPDOTransport manifest.
  • access: public
array register (xPDOTransport &$transport)
  • xPDOTransport &$transport: The xPDOTransport instance to register the vehicle into.
resolve (line 130)

Resolve any dependencies of the artifact represented in this vehicle.

  • return: Indicates if the resolution was successful.
  • access: public
boolean resolve (xPDOTransport &$transport, mixed &$object, [array $options = array ()])
  • xPDOTransport &$transport: A reference to the xPDOTransport in which this vehicle is stored.
  • mixed &$object: An object reference to resolve dependencies for. Use this to make the artifact or other important data available to the resolver scripts.
  • array $options: Additional options for the resolution process.
store (line 356)

Store this xPDOVehicle instance into an xPDOTransport.

  • return: Indicates if the vehicle was stored in the transport.
  • access: public
boolean store (xPDOTransport &$transport)
  • xPDOTransport &$transport: The transport to store the vehicle in.
uninstall (line 117)

Uninstalls the vehicle artifact from a transport host.

  • abstract:
  • access: public
void uninstall (xPDOTransport &$transport, array $options)
  • xPDOTransport &$transport: A reference to the transport.
  • array $options: An array of options for altering the uninstallation of the artifact.

Redefined in descendants as:
validate (line 252)

Validate any dependencies for the object represented in this vehicle.

  • return: Indicating if the validation was successful.
  • access: public
boolean validate (xPDOTransport &$transport, xPDOObject &$object, [array $options = array ()])
  • xPDOTransport &$transport: A reference to the xPDOTransport in which this vehicle is stored.
  • xPDOObject &$object: An object reference to access during validation.
  • array $options: Additional options for the validation process.
_compilePayload (line 380)

Compile necessary resources in preparation for storing the vehicle.

  • access: protected
void _compilePayload (xPDOTransport &$transport)
  • xPDOTransport &$transport: A reference to the transport the vehicle is being stored in.

Redefined in descendants as:

Documentation generated on Fri, 17 Jun 2011 10:04:15 -0600 by phpDocumentor 1.4.3