Arbit - project tracking

Arbit - project tracking

API documentation :: Docs For Class arbitSourceAnnotationFacade

Source::Facade::arbitSourceAnnotationFacade

Interface arbitSourceAnnotationFacade

Annotattion facade implementing all methods to access annotations of the source backend.

Annotattion facade implementing all methods to access annotations of the source backend.

Author(s):
Version:   $Revision: 1692 $
License:   GPL

Method Summary

public void attachFile( $id , $fileName , $mimeType )
Attach file to annotation Attach a file to the annotation specified by its ID. given as a third parameter and should also be stored.
public mixed createAnnotation( $file , $id )
Create a new annotation Create a new annotation with the given ID. if there already is a annotation with the given ID.
public array getAnnotationData( $id )
Get annotation data
public array getAnnotations( $file )
Get annotations for file Return an array with all annotations for the given file.
public array getAnnotationsWithMessage( )
Get all annotations with messages Get annotation list from backend, which do have a message assigned.
public string getFileContents( $id , $fileName )
Get file contents Return the contents of the file specified by its storage file name.
public void removeAllAnnotations( )
Remove all annotations Remove all annotations from the source backend.
public void updateAnnotationData( $id , $data )
Update stored information for the given annotation The array with the information to update may any number of the common keys, and only the given keys will be updated in the storage backend.

Methods

attachFile

void attachFile( mixed $id , string $fileName , string $mimeType )

Attach file to annotation Attach a file to the annotation specified by its ID. given as a third parameter and should also be stored.

Attach file to annotation Attach a file to the annotation specified by its ID. The files mime type is given as a third parameter and should also be stored.

Parameters:
Name Type Description
$id mixed
$fileName string
$mimeType string

createAnnotation

mixed createAnnotation( $file , int $id )

Create a new annotation Create a new annotation with the given ID. if there already is a annotation with the given ID.

Create a new annotation Create a new annotation with the given ID. An exception will be thrown if there already is a annotation with the given ID.

Parameters:
Name Type Description
$id int
$file

getAnnotationData

array getAnnotationData( mixed $id )

Get annotation data

Get annotation data Get the data of a given annotation, the annotation data contains of the following fields:

  • id
  • file
  • line
  • position
  • message
  • class
  • link
  • attachments

Parameters:
Name Type Description
$id mixed

getAnnotations

array getAnnotations( string $file )

Get annotations for file Return an array with all annotations for the given file.

Get annotations for file Return an array with all annotations for the given file.

Parameters:
Name Type Description
$file string

getAnnotationsWithMessage

array getAnnotationsWithMessage( )

Get all annotations with messages Get annotation list from backend, which do have a message assigned.

Get all annotations with messages Get annotation list from backend, which do have a message assigned.

getFileContents

string getFileContents( mixed $id , string $fileName )

Get file contents Return the contents of the file specified by its storage file name.

Get file contents Return the contents of the file specified by its storage file name.

Parameters:
Name Type Description
$id mixed
$fileName string

removeAllAnnotations

void removeAllAnnotations( )

Remove all annotations Remove all annotations from the source backend.

Remove all annotations Remove all annotations from the source backend.

updateAnnotationData

void updateAnnotationData( int $id , $data )

Update stored information for the given annotation The array with the information to update may any number of the common keys, and only the given keys will be updated in the storage backend.

Update stored information for the given annotation The array with the information to update may any number of the common keys, and only the given keys will be updated in the storage backend.

Parameters:
Name Type Description
$id int
$data array
Documentation generated on Mon, 05 Apr 2010 14:01:32 +0200 by phpDocumentor 1.4.3