1. class
  2. Alvine
  3. \
  4. Persistence
  5. \
  6. Provider
  7. \
  8. Memcached
  9. \
  10. DataObject

DataObject

class DataObject extends DataObjectImplementation

Memcached-Provider

Der Provider kapselt das Managment für die Arbeit mit einer Memcache-Installation

Beispiel: memcache://example.com:65432/test/objects

Properties

protected Memcache $connection
protected int $expiration

Methods

__construct(DataSource $uri)

Erstellt einen neuen Provider. Die URI muss in der Form memcached://[host]:[port] übergeben werden.

__destruct()

Resourcen freigeben

DataObject
delete(string $id)

Löscht ein Objekt

DataObject
flush()

Löscht ein den gesammten Memcache

string
read(string $id)

Liest Objekt

setExpiration(integer $seconds)

Setzt die Lebenszeit der Speicherung. Im Gegensatz zu den anderen Providern speichert der Memcache-Provider die Daten nur flüchtig.

Provider
write(string $id, string $data)

Schreibt ein Objekt

Provider
update(string $id, string $data)

Objekt aktualisieren

static DataObject
getInstanceFromProperties(Properties $properties)

Neue Instanz erstellen

Details

at line 63
__construct(DataSource $uri)

Erstellt einen neuen Provider. Die URI muss in der Form memcached://[host]:[port] übergeben werden.

Beispiel: memcached://example.com:65432

Parameters

DataSource $uri \Alvine\Net\Resource\URI $uri Datenquelle

at line 91
__destruct()

Resourcen freigeben

at line 114
DataObject delete(string $id)

Löscht ein Objekt

Löscht ein Objekt anhand seiner ID. Ist kein Objekt vorhanden, so wird eine ObjectNotFoundException geworfen. Bestimmte Provider können noch andere Providerspezifische Exceptions werfen.

Parameters

string $id ID des Objekts (z.B. UUID)

Return Value

DataObject Dieses Objekt

Exceptions

DataObjectException Wenn Fehler beim Löschen auftritt
ObjectNotFoundException Wenn es kein Objekt mit dieser ID gibt

at line 129
DataObject flush()

Löscht ein den gesammten Memcache

Return Value

DataObject Dieses Objekt

at line 147
string read(string $id)

Liest Objekt

Diese Methode sucht ein Objekt anhand einer ID und gibt die gespeicherten Daten zurück. Ist unter dieser ID kein Objekt gespeichert, so wird eine ObjectNotFoundException geworfen.

Parameters

string $id ID des Objekts (z.B. UUID)

Return Value

string Objekt als serialisierter String

Exceptions

ObjectNotFoundException Wenn das Objekt nicht existiert

at line 161
setExpiration(integer $seconds)

Setzt die Lebenszeit der Speicherung. Im Gegensatz zu den anderen Providern speichert der Memcache-Provider die Daten nur flüchtig.

Parameters

integer $seconds Lebensdauer

at line 179
Provider write(string $id, string $data)

Schreibt ein Objekt

Schreibt die Daten eines serialisierten Objekts. Wenn bereits ein Objekt unter dieser ID vorhanden ist, so wird dieses Objekt ohne Prüfung überschrieben, ansonsten wird die ID neu angelegt.

Parameters

string $id ID des Objekts (z.B. UUID)
string $data Zu speichernde Daten (serialisiertes Objekt)

Return Value

Provider Dieses Objekt

Exceptions

DataObjectException Bei Problemen mit dem Schreiben

at line 203
Provider update(string $id, string $data)

Objekt aktualisieren

Ändert die serialisierten Daten im Speicherbereich. Wird die übergebene ID nicht gefunden, so wird eine ObjectNotFoundException geworfen.

Parameters

string $id ID des Objekts (z.B. UUID)
string $data Zu speichernde Daten (serialisiertes Objekt)

Return Value

Provider Dieses Objekt

Exceptions

DataObjectException Bei Problemen mit dem Schreiben

at line 226
static DataObject getInstanceFromProperties(Properties $properties)

Neue Instanz erstellen

Erstellt einen neuen Provider und initialisiert die Werte über ein Property-Objekt. Die gültigen Eigenschaften sind:

uri URI des Memcache in der Form memcache://host1[:port1]

Parameters

Properties $properties Eigenschaften

Return Value

DataObject Neues Objekt