Base Class Reference

Inheritance diagram for Base:

Collaboration diagram for Base:

Public Member Functions
	__construct ($id=null, $user=null)
	getPermissions ()
	setUser ($user)
	hasUser ()
	getUser ()
Public Member Functions inherited from SimpleORMap
	__construct ($id=null)
	__clone ()
	getRelationOptions ($relation)
	getTableMetadata ()
	hasAutoIncrementColumn ()
	setId ($id)
	getId ()
	getNewId ()
	toArray ($only_these_fields=null)
	toRawArray ($only_these_fields=null)
	toArrayRecursive ($only_these_fields=null)
	getValue ($field)
	getRelationValue ($relation, $field)
	setValue ($field, $value)
	__get ($field)
	__set ($field, $value)
	__isset ($field)
	offsetExists ($offset)
	offsetGet ($offset)
	offsetSet ($offset, $value)
	offsetUnset ($offset)
	getIterator ()
	count ()
	isField ($field)
	isAdditionalField ($field)
	isAliasField ($field)
	setData ($data, $reset=false)
	haveData ()
	isNew ()
	isDeleted ()
	setNew ($is_new)
	getWhereQuery ()
	restore ()
	store ()
	triggerChdate ()
	delete ()
	isDirty ()
	isFieldDirty ($field)
	revertValue ($field)
	getPristineValue ($field)
	initRelation ($relation)
	resetRelation ($relation)

Static Public Member Functions
static	detect ()
static	addType ($type, $class)
static	removeType ($type)
static	find ($id)
static	findAll ()
static	create ($type)
static	detectConsumer ($type=null, $request_type=null, $request_body=null)
Static Public Member Functions inherited from SimpleORMap
static	expireTableScheme ()
static	find ($id)
static	exists ($id)
static	countBySql ($sql=1, $params=array())
static	create ($data)
static	build ($data, $is_new=true)
static	buildExisting ($data)
static	import ($data)
static	findBySQL ($sql, $params=array())
static	findByObject (SimpleORMap $object)
static	findOneBySQL ($where, $params=array())
static	findThru ($foreign_key_value, $options)
static	findEachBySQL ($callable, $sql, $params=array())
static	findMany ($pks=array(), $order='', $order_params=array())
static	findEachMany ($callable, $pks=array(), $order='', $order_params=array())
static	findAndMapBySQL ($callable, $where, $params=array())
static	findAndMapMany ($callable, $pks=array(), $order='', $order_params=array())
static	deleteBySQL ($where, $params=array())
static	toObject ($id_or_object)
static	__callStatic ($name, $arguments)

Static Protected Member Functions
static	configure ($config=array())
Static Protected Member Functions inherited from SimpleORMap
static	configure ($config=array())
static	tableScheme ($db_table)

Protected Attributes
	$user = null
Protected Attributes inherited from SimpleORMap
	$content = array()
	$content_db = array()
	$is_new = true
	$is_deleted = false
	$db_table = ''
	$db_fields = null
	$pk = null
	$default_values = array()
	$serialized_fields = array()
	$alias_fields = array()
	$additional_fields = array()
	$relations = array()
	$has_many = array()
	$has_one = array()
	$belongs_to = array()
	$has_and_belongs_to_many = array()
	$registered_callbacks
	$known_slots = array()
	$reserved_slots = array('value','newid','iterator','tablemetadata', 'relationvalue','wherequery','relationoptions','data','new','id')
	$notification_map = array()
	$additional_data = array()

Static Protected Attributes
static	$known_types = array()
Static Protected Attributes inherited from SimpleORMap
static	$schemes = null
static	$config = array()

Additional Inherited Members
Protected Member Functions inherited from SimpleORMap
	_getId ($field)
	_setId ($field, $value)
	_getAdditionalValueFromRelation ($field)
	_setAdditionalValueFromRelation ($field, $value)
	_getAdditionalValue ($field)
	_setAdditionalValue ($field, $value)
	parseRelationOptions ($type, $name, $options)
	getTableScheme ()
	storeRelations ($only_these=null)
	deleteRelations ()
	initializeContent ()
	applyCallbacks ($type)
	registerCallback ($types, $cb)
	unregisterCallback ($types, $cb)
	cbAutoIncrementColumn ($type)
	cbAutoKeyCreation ()
	cbNotificationMapper ($cb_type)
	setSerializedValue ($field, $value)

Detailed Description

Base consumer class for the rest api

Consumers provide means for authenticating a user and the access permissions for routes are bound to specific consumers.

Author

Jan-Hendrik Willms tleil.nosp@m.ax+s.nosp@m.tudip.nosp@m.@gma.nosp@m.il.co.nosp@m.m @license GPL 2 or later

Since

Stud.IP 3.0

Constructor & Destructor Documentation

__construct()

__construct	(		$id = null,
			$user = null
	)

Extended SimpleORMap constructor. A certain user can be injected upon creation.

Parameters

mixed	$id	Id of the consumer or null to create a new one
mixed	$user	Either a user object or id to inject to the consumer or null if no user should be injected

Here is the call graph for this function:

Member Function Documentation

addType()

static addType (   $type,   $class  )

static

Add a consumer type to the list of consumer types

Parameters

String	$type	Name of the type
String	$class	Associated consumer class

configure()

static configure (   $config = array() )

staticprotected

Configures the model.

Parameters

array

$config

Configuration array

Reimplemented from SimpleORMap.

Reimplemented in OAuth.

create()

static create (   $type )

static

Creates a new consumer of the given type.

Parameters

String

$type

Name of the type

Returns

RESTAPI\Consumer\Base Consumer object of the given (derived from consumer base type)

Exceptions

Exception

if type is invalid

Reimplemented from SimpleORMap.

Here is the caller graph for this function:

detect()

static detect ( )

staticabstract

Each consumer type has to implement a detect feature which should extract crucial information from the request and return an instance of itself if the consumer detects a valid signature it can respond to.

Returns

mixed Detected consumer object or false

Reimplemented in HTTP, and Studip.

detectConsumer()

static detectConsumer (   $type = null,   $request_type = null,   $request_body = null  )

static

This method is used to detect a consumer (of a specific type) by executing the detect method on all known consumer types.

Parameters

mixed	$type	Name of the type (optional; defaults to all types)
mixed	$request_type	Type of request (optional; defaults to any)
mixed	$request_body	Request body to use (optional, should be removed when Stud.IP requires PHP >= 5.6)

Returns

mixed Either the detected consumer or false if no consumer was detected

Exceptions

Exception

if type is invalid

Here is the caller graph for this function:

find()

static find (   $id )

static

Overloaded find method. Will return a concrete specialized consumer object of the associated type.

Parameters

String

$id

Id of the consumer

Returns

RESTAPI\Consumer\Base Associated consumer object (derived from consumer base type)

Exceptions

Exception

if either consumer id or consumer type is invalid

Reimplemented from SimpleORMap.

Here is the call graph for this function:

Here is the caller graph for this function:

findAll()

static findAll ( )

static

Returns a list of all known consumers.

Returns

Array List of all known consumers (as specialized consumer objects)

Here is the call graph for this function:

Here is the caller graph for this function:

getPermissions()

getPermissions

(

)

Retrieve the api permissions associated with this consumer.

Returns

RESTAPI\ConsumerPermissions Permission object for this consumer

getUser()

getUser

(

)

Return the injected user.

Parameters

mixed

User object or false if no user was injected

hasUser()

hasUser

(

)

Returns whether the consumer has an injected user or not.

Returns

bool True if a valid user is found, false otherwise

Here is the caller graph for this function:

removeType()

static removeType (   $type )

static

Removes a consumer type from the list of consumer types

Parameters

String

$type

Name of the type

setUser()

setUser

(

$user

)

Inject a user to this consumer. Injecting in this context refers to "having a user authenticated by this consumer".

Parameters

mixed

$user

Either a user object or a user id

Returns

RESTAPI\Consumer\Base Returns instance of self to allow chaining

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$known_types

$known_types = array()

staticprotected

Stores all known consumer types

$user

$user = null

protected

Contains user information

---

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

• lib/classes/restapi/consumer/Base.php