Class: DataException

Source Location: /DataExceptions.php

Class Overview [line 52]


Basisklasse für alle konkreten Exceptions

Author(s):

  • Matthias Ansorg <matthias at ansorgs dot de>

Version:

Copyright:

Variables

Constants

Methods


Child classes:

InvalidOperationException
Ausgelöst, wenn ein Methodenaufruf unzulässig ist aus Gründen, die nicht an den übergebenen Parametern sondern am Zustand des Objektes selbst liegen.
DataRowException
Klasse zum Behandeln von Exceptions, die durch DataRow geworfen werden.

Inherited Variables

Inherited Constants

Inherited Methods



Class Details

Basisklasse für alle konkreten Exceptions

Im Wesentlichen nur eine Vorbereitung, um eine Migration auf PHP5 mit der dort PHP-internen Klasse "Exception" zu vereinfachen.

Das Konzept der Exception-Behandlung in PHP4

Alle konkreten Exceptions sind Objekte von Klassen, die von "Exception" abgeleitet wurden und deren Name mit "Exception" endet. Jede Methode, die Exceptions wirft oder Events erzeugt, verlangt als Referenzparameter ein Array. An dieses werden alle neu erzeugten Exceptions angehängt. Die rufende Methode kann dann die geworfenen Exceptions auswerten.

Dieses Exception-Konzept wurde für die Reimplementierung des Microsoft .NET-DataSets in PHP entwickelt. Um diese Aufgabe zu vereinfachen, wird es auch gleich anstelle des Ereigniskonzepts eingesetzt. Damit können sowohl Ereignisse als auch Exceptions im zurückgegebenen Array enthalten sein.

Alle konkreten Ereignisse sind Objekte von Klassen, die von "Event" abgeleitet wurden. Ihr Name kann, muss aber nicht mit "Event" enden.

Um die doppelte Verwendung des Arrays für Ereignisse und Exceptions auszudrücken, sollte der entsprechende Parameter $signalQueue genannt werden.

Tags:

[ Top ]


Class Variables

$Message =

[line 62]

textuelle Beschreibung dieser Exception

get-Methode dieses Attributs: message

Tags:

  • access - private

Type: string

Overrides:

[ Top ]

$Source =

[line 102]

Name der Anwendung oder des Objektes, das die Fehlerursache dieser Exception ist

get/set-Methode dieses Attributs: source

Tags:

  • access - private

Type: string

Overrides:

[ Top ]

$TargetSite =

[line 130]

Name der Methode, die diese Exception wirft

get-Methode dieses Attributs: targetSite

Tags:

  • access - private

Type: string

Overrides:

[ Top ]


Class Methods

DataException

DataException DataException( string $Message, string $TargetSite)

[line 77]

Konstruktor mit Angabe einer textuellen Beschreibung der Exception und der werfenden Methode

Tags:

  • access - public

Parameters:

  • string $Message - textuelle Beschreibung der Exception, die durch das zu erstellende Objekt der Klasse Exception repräsentiert werden soll. Diese Beschreibung kann später durch message ausgelesen werden.
  • string $TargetSite - Name der Methode, die diese Exception wirft, d.h. der Name der eigenen Methode. Dieser Name kann später durch targetSite ausgelesen werden. Der Name soll aus dem Namen der Klasse gefolgt vom Bereichsauflösungsoperator "::" und dem Namen der Methode der Klasse bestehen. Bei freien Methoden entfallen Klassenname und "::".

[ Top ]

message

string message( )

[line 90]

textuelle Beschreibung dieser Exception (lesen)

Ermittelt eine textuelle Beschreibung dieser Exception. get-Methode des Attributs Message

Tags:

  • return - textuelle Beschreibung dieser Exception
  • access - public

Parameters:

[ Top ]

source

string source( [string $Source = null])

[line 115]

Name der Anwendung oder des Objektes, das die Fehlerursache dieser Exception ist (lesen, schreiben).

get/set-Methode des Attributs Source

Tags:

  • return - aktueller Wert des Attributs Source
  • access - public

Parameters:

  • string $Source - Wert, den das Attribut Source annehmen soll. Optional. Der Parameter wird nur verwendet, wenn die Methode als set-Methode eingesetzt wird.

[ Top ]

targetSite

string targetSite( )

[line 140]

Name der Methode, die diese Exception wirft (lesen)

get-Methode des Attributs TargetSite

Tags:

  • return - Name der Methode, die diese Exception wirft
  • access - public

Parameters:

[ Top ]


Class Methods


Documentation generated on Tue, 27 Jul 2004 21:15:30 +0200 by phpDocumentor 1.3.0RC3