|
|
@@ -1,19 +1,19 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
<!-- EN-Revision: 17583 -->
|
|
|
-<!-- Reviewed: no -->
|
|
|
+<!-- Reviewed: 17583 -->
|
|
|
<sect1 id="zend.controller.response">
|
|
|
- <title>Das Response Objekt</title>
|
|
|
+ <title>Das Response-Objekt</title>
|
|
|
|
|
|
<sect2 id="zend.controller.response.usage">
|
|
|
<title>Verwendung</title>
|
|
|
|
|
|
<para>
|
|
|
- Das Response Objekt ist das logische Gegenstück zum <link
|
|
|
- linkend="zend.controller.request">Request Objekt</link>. Sein Zweck ist es,
|
|
|
- Inhalte und / oder Header zu vereinigen, um sie in einem Rutsch zu versenden.
|
|
|
- Zusätzlich übergibt der Front Controller alle aufgefangenen Ausnahmen an das Response
|
|
|
- Objekt, um dem Entwickler das Verarbeiten von Ausnahmen zu ermöglichen. Dies
|
|
|
- Funktionalität kann durch Setzen von
|
|
|
+ Das Response-Objekt ist das logische Gegenstück zum <link
|
|
|
+ linkend="zend.controller.request">Request-Objekt</link>. Sein Zweck ist es,
|
|
|
+ Inhalte und/oder Header zu vereinigen, um sie in einem Rutsch zu versenden.
|
|
|
+ Zusätzlich übergibt der FrontController alle aufgefangenen Ausnahmen an das
|
|
|
+ Response-Objekt, um dem Entwickler das Verarbeiten von Ausnahmen zu ermöglichen.
|
|
|
+ Diese Funktionalität kann durch Setzen von
|
|
|
<methodname>Zend_Controller_Front::throwExceptions(true)</methodname> überschrieben
|
|
|
werden.
|
|
|
</para>
|
|
|
@@ -23,7 +23,7 @@ $front->throwExceptions(true);
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Um die Ausgabe der Response, inklusiver der gesetzten Header, zu senden, verwendet man
|
|
|
+ Um die Ausgabe der Anwort inklusive der gesetzten Header zu senden, verwendet man
|
|
|
<methodname>sendResponse()</methodname>:
|
|
|
</para>
|
|
|
|
|
|
@@ -33,11 +33,11 @@ $response->sendResponse();
|
|
|
|
|
|
<note>
|
|
|
<para>
|
|
|
- Standardmäßig ruft der Front Controller <methodname>sendResponse()</methodname> auf
|
|
|
- wenn er die Anfrage fertig bearbeitet hat; typischerweise wird es nie notwendig
|
|
|
- sein Ihn aufzurufen. Wenn man trotzdem die Antwort manipulieren will oder Sie beim
|
|
|
+ Standardmäßig ruft der FrontController <methodname>sendResponse()</methodname> auf,
|
|
|
+ wenn er die Anfrage fertig bearbeitet hat; nerweise wird es nie notwendig
|
|
|
+ sein ihn aufzurufen. Wenn man trotzdem die Antwort manipulieren will oder sie beim
|
|
|
Testen verwenden will, kann dieses Verhalten durch das Setzen des
|
|
|
- <property>returnResponse</property> Flags mit
|
|
|
+ Flags <property>returnResponse</property> mit
|
|
|
<methodname>Zend_Controller_Front::returnResponse(true)</methodname> geändert
|
|
|
werden:
|
|
|
</para>
|
|
|
@@ -45,16 +45,16 @@ $response->sendResponse();
|
|
|
<programlisting language="php"><![CDATA[$front->returnResponse(true);
|
|
|
$response = $front->dispatch();
|
|
|
|
|
|
-// ein bischen mehr verarbeiten, wie z.B. loggen...
|
|
|
+// ein bisschen mehr verarbeiten, wie z.B. loggen...
|
|
|
// und dann die Ausgabe senden:
|
|
|
$response->sendResponse();
|
|
|
]]></programlisting>
|
|
|
</note>
|
|
|
|
|
|
<para>
|
|
|
- Entwickler sollten das Response Objekt in ihren Aktionscontrollern verwenden. Statt
|
|
|
- die Ausgabe direkt zu machen und Header zu versenden, sollten diese an des Response
|
|
|
- Objekt übergeben werden:
|
|
|
+ Entwickler sollten das Response-Objekt in ihren Aktions-Controllern verwenden.
|
|
|
+ Statt die Ausgabe direkt zu machen und Header zu versenden, sollten diese an das
|
|
|
+ Response-Objekt übergeben werden:
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
@@ -72,25 +72,25 @@ $this->getResponse()
|
|
|
<note>
|
|
|
<para>
|
|
|
Wenn die <link linkend="zend.controller.action.viewintegration">View
|
|
|
- Integration</link> des Aktion Controllers verwendet wird muß der bearbeitete
|
|
|
- Inhalt des View Skripts im Antwort Objekt nicht gesetzt werden, da die
|
|
|
+ Integration</link> des Aktions-Controllers verwendet wird, muss der bearbeitete
|
|
|
+ Inhalt des View-Skripts im Response-Objekt nicht gesetzt werden, da die
|
|
|
<methodname>Zend_Controller_Action::render()</methodname> das standardmäßig macht.
|
|
|
</para>
|
|
|
</note>
|
|
|
|
|
|
<para>
|
|
|
Sollte in der Anwendung eine Ausnahme auftreten, überprüft man den
|
|
|
- <methodname>isException()</methodname> Schalter des Response Objektes und erhält die
|
|
|
+ Schalter <methodname>isException()</methodname> des Response-Objekts und erhält die
|
|
|
Ausnahme durch Verwendung von <methodname>getException()</methodname>. Zusätzlich kann
|
|
|
- man ein eigenes Response Objekt erstellen, dass zu einer Fehlerseite umleitet, die
|
|
|
+ man ein eigenes Response-Objekt erstellen, das zu einer Fehlerseite umleitet, die
|
|
|
Nachricht der Ausnahme loggt, die Nachricht der Ausnahme schön formatiert ausgibt (für
|
|
|
Entwicklungsumgebungen), usw.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Man kann das Response Objekt im Anschluß an die <methodname>dispatch()</methodname>
|
|
|
- Methode des Front Controllers erhalten oder den Front Controller auffordern, dass
|
|
|
- Response Objekt zurückzugeben statt den Inhalt auszugeben.
|
|
|
+ Man kann das Response-Objekt im Anschluss an die Methode <methodname>dispatch()</methodname>
|
|
|
+ des FrontControllers erhalten oder den FrontController auffordern, das
|
|
|
+ Response-Objekt zurückzugeben statt den Inhalt auszugeben.
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
@@ -101,20 +101,20 @@ if ($response->isException()) {
|
|
|
// log, mail, etc...
|
|
|
}
|
|
|
|
|
|
-// Oder den Front Controller dispatch Prozess auffordern, es zurück zu geben
|
|
|
+// Oder den FrontController-Dispatch-Prozess auffordern, es zurück zu geben
|
|
|
$front->returnResponse(true);
|
|
|
$response = $front->dispatch();
|
|
|
|
|
|
// mach irgend was...
|
|
|
|
|
|
-// zum Schluß, gib die Antwort aus
|
|
|
+// gib zum Schluß die Antwort aus
|
|
|
$response->sendResponse();
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Standardmäßig werden Ausnahmennachrichten nicht ausgegeben. Dieses Verhalten kann durch
|
|
|
+ Standardmäßig werden Ausnahmenachrichten nicht ausgegeben. Dieses Verhalten kann durch
|
|
|
den Aufruf von <methodname>renderException()</methodname> überschrieben werden oder
|
|
|
- indem der Front Controller aufgefordert wird, die Exceptions durch
|
|
|
+ indem der FrontController aufgefordert wird, die Exceptions durch
|
|
|
<methodname>throwExceptions()</methodname> auszuwerfen, wie oben gezeigt:
|
|
|
</para>
|
|
|
|
|
|
@@ -138,17 +138,17 @@ $front->dispatch();
|
|
|
<title>Header manipulieren</title>
|
|
|
|
|
|
<para>
|
|
|
- Wie vorher besprochen, ist einer der Aspekte der Antwort Objekt Aufgaben das Sammeln und
|
|
|
- Abschicken der <acronym>HTTP</acronym> Antwort Header. Eine Vielzahl von Methoden
|
|
|
+ Wie vorher besprochen, ist einer der Aspekte der Aufgaben des Response-Objekts das Sammeln und
|
|
|
+ Abschicken der <acronym>HTTP</acronym>-Antwort-Header. Eine Vielzahl von Methoden
|
|
|
existieren hierfür:
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>canSendHeaders()</methodname> wird verwendet um zu ermitteln ob
|
|
|
- bereits Header gesendet wurden. Sie nimmt ein zusätzliches Flag das zeigt ob
|
|
|
- eine Ausnahme geworfen werden soll oder nicht, wenn bereits Header gesendet
|
|
|
+ <methodname>canSendHeaders($throw = false)</methodname> wird verwendet,
|
|
|
+ um zu ermitteln, ob bereits Header gesendet wurden. Ein optionaler Parameter bestimmt,
|
|
|
+ ob eine Ausnahme geworfen werden soll oder nicht, wenn bereits Header gesendet
|
|
|
wurden. Das kann durch das Setzen der Eigenschaft
|
|
|
<property>headersSentThrowsException</property> zu <constant>FALSE</constant>
|
|
|
überschrieben werden.
|
|
|
@@ -158,16 +158,16 @@ $front->dispatch();
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>setHeader($name, $value, $replace = false)</methodname> wird
|
|
|
- verwendet um einen individuellen Header zu setzen. Standardmäßig, ersetzt das
|
|
|
- keinen bereits existierenden gleichnamigen Header im Objekt; Trotzdem wird das
|
|
|
- Setzen von <varname>$replace</varname> zu <constant>TRUE</constant> es forcieren
|
|
|
- das zu tun.
|
|
|
+ verwendet, um einen individuellen Header zu setzen. Standardmäßig ersetzt das
|
|
|
+ keinen bereits existierenden gleichnamigen Header im Objekt; allerdings wird das
|
|
|
+ Setzen von <varname>$replace</varname> zu <constant>TRUE</constant> dies
|
|
|
+ erzwingen.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Bevor der Header setzt wird, prüft er mit
|
|
|
- <methodname>canSendHeaders()</methodname> um zu sehen ob diese Operation zu
|
|
|
- diesem Zeitpunkt erlaubt ist, und erzwingt das eine Ausnahme geworfen wird.
|
|
|
+ Vor dem Setzen des Headers wird mit <methodname>canSendHeaders()</methodname>
|
|
|
+ geprüft, ob diese Operation zu diesem Zeitpunkt erlaubt ist
|
|
|
+ und erzwingt, dass eine Ausnahme geworfen wird.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
@@ -181,28 +181,28 @@ $front->dispatch();
|
|
|
|
|
|
<para>
|
|
|
Intern wird <methodname>setHeader()</methodname> mit dem
|
|
|
- <varname>$replace</varname> Flag aufgerufen um sicherzustellen das nur ein
|
|
|
- solcher Header jemals gesendet wird.
|
|
|
+ <varname>$replace</varname>-Flag aufgerufen um sicherzustellen, dass nur ein
|
|
|
+ solcher Header gesendet wird.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>getHeaders()</methodname> gibt ein Array aller Header zurück. Jedes
|
|
|
- Array Element ist ein Array mit den Schlüsseln 'name' und 'value'.
|
|
|
+ Array-Element ist ein Array mit den Schlüsseln 'name' und 'value'.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>clearHeaders()</methodname> löscht alle registrierten Headern.
|
|
|
+ <methodname>clearHeaders()</methodname> löscht alle registrierten Header.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>setRawHeader()</methodname> kann verwendet werden um Header zu
|
|
|
- setzen die keine Schlüssel und Werte Paare sind, wie einen
|
|
|
+ setzen, die keine Schlüssel-und-Werte-Paare sind, wie einen
|
|
|
<acronym>HTTP</acronym> Status Header.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -224,14 +224,14 @@ $front->dispatch();
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>clearAllHeaders()</methodname> löscht beide, reguläre
|
|
|
- Schlüssel und Werte Header genauso wie rohe Header.
|
|
|
+ Schlüssel-und-Werte-Header genauso wie rohe Header.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
<para>
|
|
|
- Zusätzlich zu den obigen Methoden, gint es Accessors für das Setzen und Empfangen der
|
|
|
- <acronym>HTTP</acronym> Antwort Codes für die aktuellen Anfrage,
|
|
|
+ Zusätzlich zu den obigen Methoden, gibt es Zugriffsmethoden für das Setzen und
|
|
|
+ Empfangen der <acronym>HTTP</acronym>-Antwort-Codes für die aktuellen Anfrage,
|
|
|
<methodname>setHttpResponseCode()</methodname> und
|
|
|
<methodname>getHttpResponseCode()</methodname>.
|
|
|
</para>
|
|
|
@@ -241,16 +241,16 @@ $front->dispatch();
|
|
|
<title>Benannte Segmente</title>
|
|
|
|
|
|
<para>
|
|
|
- Das Antwort Objekt unterstützt "benannte Segmente". Das erlaubt es den Inhalt des Bodys
|
|
|
- in verschiedene Segmente zu isolieren und diese Segmente zu reihen damit die Ausgabe in
|
|
|
+ Das Response-Objekt unterstützt "benannte Segmente". Das erlaubt es den Inhalt des Bodys
|
|
|
+ in verschiedene Segmente zu isolieren und diese Segmente zu reihen, damit die Ausgabe in
|
|
|
einer spezifizierten Reihenfolge zurückgegeben wird. Intern wird der Inhalt der Bodys in
|
|
|
- einem Array gespeichert und die verschiedenen Accessor Methoden können verwendet werden
|
|
|
- um die Plazierung und Benamung innerhalb des Arrays zu indizieren.
|
|
|
+ einem Array gespeichert und die verschiedenen Zugriffsmethoden können verwendet werden,
|
|
|
+ um die Platzierung und Benennung innerhalb des Arrays zu indizieren.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Als Beispiel könnte ein <methodname>preDispatch()</methodname> Hook verwendet werden um
|
|
|
- dem Antwort Objekt einen Header hinzuzufügen, dann den Aktion Controller einen Inhalt
|
|
|
+ Als Beispiel könnte ein <methodname>preDispatch()</methodname> Hook verwendet werden, um
|
|
|
+ dem Response-Objekt einen Header hinzuzufügen, dann den Aktionscontroller einen Inhalt
|
|
|
des Bodys hinzufügen zu lassen und einen <methodname>postDispatch()</methodname> Hook
|
|
|
einen Footer hinzufügen zu lassen:
|
|
|
</para>
|
|
|
@@ -290,7 +290,7 @@ class MyController extends Zend_Controller_Action
|
|
|
|
|
|
<para>
|
|
|
Im obigen Beispiel wird ein Aufruf zu <filename>/my/foo</filename> den endgültigen
|
|
|
- Inhalt des Bodys des Antwort Objekts mit der folgenden Struktur verursachen:
|
|
|
+ Inhalt des Bodys des Antwortobjekts mit der folgenden Struktur verursachen:
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
@@ -302,12 +302,12 @@ array(
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- Wenn das gerendert wird, wird es in der Reihenfolge gerendert in dem die Elements im
|
|
|
+ Wenn das gerendert wird, wird es in der Reihenfolge gerendert, in der die Elements im
|
|
|
Array angeordnet sind.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Eine Vielzahl von Methoden kann verwendet werden um die benannten Segmente zu
|
|
|
+ Eine Vielzahl von Methoden kann verwendet werden, um die benannten Segmente zu
|
|
|
manipulieren:
|
|
|
</para>
|
|
|
|
|
|
@@ -315,9 +315,9 @@ array(
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>setBody()</methodname> und <methodname>appendBody()</methodname>
|
|
|
- erlauben das ein zweiter Wert, <varname>$name</varname>, übergeben wird der ein
|
|
|
- benanntes Segment indiziert. In jedem Fall wird, wenn das übergeben wird, das
|
|
|
- spezifizierte benannte Segment überschrieben oder es wird erstellt wenn es
|
|
|
+ erlauben die Übergabe eines zweiten Werts <varname>$name</varname>, der ein
|
|
|
+ benanntes Segment kennzeichnet. In jedem Fall wird bei der Übergabe das
|
|
|
+ spezifizierte benannte Segment überschrieben oder es wird erstellt, wenn es
|
|
|
nicht existiert (standardmäßig dem Array hinzugefügt). Wenn kein benanntes
|
|
|
Segment an <methodname>setBody()</methodname> übergeben wird, setzt es den
|
|
|
kompletten Inhalt des Body Arrays zurück. Wenn kein benanntes Segment an
|
|
|
@@ -329,30 +329,30 @@ array(
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>prepend($name, $content)</methodname> erstellt ein
|
|
|
- <varname>$name</varname> benanntes Segment und plaziert dieses ab Beginn des
|
|
|
+ benanntes Segment <varname>$name</varname> und platziert dieses am Beginn des
|
|
|
Arrays. Wenn das Segment bereits existiert, wird es vor der Operation entfernt
|
|
|
- (bzw, überschrieben und getauscht).
|
|
|
+ (bzw. überschrieben und ersetzt).
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>append($name, $content)</methodname> erstellt ein
|
|
|
- <varname>$name</varname> benanntes Segment und plaziert es am Ende des Arrays.
|
|
|
- Wenn das Segment bereits existiert, wird es vor der Operation entfernt (bzw,
|
|
|
- überschrieben und getauscht).
|
|
|
+ benanntes Segment <varname>$name</varname> und platziert es am Ende des Arrays.
|
|
|
+ Wenn das Segment bereits existiert, wird es vor der Operation entfernt (bzw.
|
|
|
+ überschrieben und ersetzt).
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>insert($name, $content, $parent = null, $before =
|
|
|
- false)</methodname> erstellt ein <varname>$name</varname> benanntes
|
|
|
- Segment. Wenn ein <varname>$parent</varname> Segment angegeben wurde, wird das
|
|
|
- neue Segment entweder vor oder nach diesem Segment im Array plaziert (basierend
|
|
|
+ false)</methodname> erstellt ein benanntes Segment <varname>$name</varname>.
|
|
|
+ Wenn ein <varname>$parent</varname>-Segment angegeben wurde, wird das
|
|
|
+ neue Segment entweder vor oder nach diesem Segment im Array platziert (basierend
|
|
|
auf dem Wert von <varname>$before</varname>). Wenn das Segment bereits
|
|
|
- existiert, wird es vor der Operation entfernt (bzw, überschrieben und
|
|
|
- getauscht).
|
|
|
+ existiert, wird es vor der Operation entfernt (bzw. überschrieben und
|
|
|
+ ersetzt).
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
@@ -366,11 +366,11 @@ array(
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getBody($spec = false)</methodname> kann verwendet werden um ein
|
|
|
- einzelnes Array Segment zu erhalten wenn <varname>$spec</varname> der Name des
|
|
|
+ <methodname>getBody($spec = false)</methodname> kann verwendet werden, um ein
|
|
|
+ einzelnes Array Segment zu erhalten, wenn <varname>$spec</varname> der Name des
|
|
|
benannten Segments ist. Wenn <varname>$spec</varname> <constant>FALSE</constant>
|
|
|
- ist, gibt es einen String zurück der erstellt wird durch zusammenfügen aller
|
|
|
- benannten Segmente in Ihrer Reihenfolge. Wenn <varname>$spec</varname>
|
|
|
+ ist, gibt es einen String zurück, der durch Zusammenfügen aller benannten
|
|
|
+ Segmente in ihrer Reihenfolge erstellt wird. Wenn <varname>$spec</varname>
|
|
|
<constant>TRUE</constant> ist, gibt er das Array des Body Inhalts zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -378,63 +378,63 @@ array(
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.controller.response.exceptions">
|
|
|
- <title>Auf Ausnahmen im Antwort Objekt testen</title>
|
|
|
+ <title>Testen auf Ausnahmen im Response-Objekt</title>
|
|
|
|
|
|
<para>
|
|
|
- Wie vorher beschrieben werden Ausnahmen standardmäßig wärend des Dispatchens gefangen
|
|
|
- und im Antwort Objekt registriert. Ausnahmen werden in einem Stack registriert, der es
|
|
|
- erlaubt alle Ausnahmen geworfen zu lassen -- Anwendungs Ausnahmen, Dispatch Ausnahmen,
|
|
|
- Plugin Ausnahmen, usw. Wenn man auf bestimmte Ausnahmen prüfen will oder Ausnahmen
|
|
|
- loggen will, muß man die Ausnahme <acronym>API</acronym> des Antwort Objekts verwenden:
|
|
|
+ Wie vorher beschrieben werden Ausnahmen standardmäßig während des Dispatchens gefangen
|
|
|
+ und im Response-Objekt registriert. Ausnahmen werden in einem Stack registriert, der es
|
|
|
+ erlaubt alle geworfen Ausnahmen zu speichern -- Anwendungsausnahmen, Dispatch-Ausnahmen,
|
|
|
+ Plugin-Ausnahmen, usw. Wenn man auf bestimmte Ausnahmen prüfen oder Ausnahmen
|
|
|
+ loggen will, muß man die Ausnahme-<acronym>API</acronym> des Response-Objekts verwenden:
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>setException(Exception $e)</methodname> erlaubt es eine Ausnahme zu
|
|
|
+ <methodname>setException(Exception $e)</methodname> erlaubt es, eine Ausnahme zu
|
|
|
registrieren.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>isException()</methodname> sagt ob eine Ausnahme bereits
|
|
|
+ <methodname>isException()</methodname> sagt, ob eine Ausnahme bereits
|
|
|
registriert wurde.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getException()</methodname> gibt den kompletten Ausnahme Stack
|
|
|
+ <methodname>getException()</methodname> gibt den kompletten Ausnahme-Stack
|
|
|
zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>hasExceptionOfType($type)</methodname> erlaub es festzustellen ob
|
|
|
- eine Ausnahme einer speziellen Klasse im Stack vorhanden ist.
|
|
|
+ <methodname>hasExceptionOfType($type)</methodname> erlaubt es festzustellen,
|
|
|
+ ob eine Ausnahme einer speziellen Klasse im Stack vorhanden ist.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>hasExceptionOfMessage($message)</methodname> erlaubt es
|
|
|
- festzustellen ob eine Ausnahme mit einer speziellen Nachricht im Stack
|
|
|
+ festzustellen, ob eine Ausnahme mit einer speziellen Nachricht im Stack
|
|
|
vorhanden ist.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>hasExceptionOfCode($code)</methodname> erlaubt es festzustellen ob
|
|
|
- eine Ausnahme mit einem bestimmten Code im Stack vorhanden ist.
|
|
|
+ <methodname>hasExceptionOfCode($code)</methodname> erlaubt es festzustellen,
|
|
|
+ ob eine Ausnahme mit einem bestimmten Code im Stack vorhanden ist.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getExceptionByType($type)</methodname> erlaubt es alle Ausnahmen
|
|
|
+ <methodname>getExceptionByType($type)</methodname> erlaubt es, alle Ausnahmen
|
|
|
einer speziellen Klasse vom Stack zu erhalten. <constant>FALSE</constant> wird
|
|
|
zurückgegeben wenn keine gefunden wurden, und andernfalls ein Array mit
|
|
|
Ausnahmen.
|
|
|
@@ -443,55 +443,55 @@ array(
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getExceptionByMessage($message)</methodname> erlaubt es alle
|
|
|
+ <methodname>getExceptionByMessage($message)</methodname> erlaubt es, alle
|
|
|
Ausnahmen mit einer speziellen Nachricht vom Stack zu erhalten.
|
|
|
- <constant>FALSE</constant> wird zurückgegeben wenn keine gefunden wurden, und
|
|
|
+ <constant>FALSE</constant> wird zurückgegeben, wenn keine gefunden wurden, und
|
|
|
andernfalls ein Array mit Ausnahmen.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getExceptionByCode($code)</methodname> erlaubt es alle Ausnahmen
|
|
|
+ <methodname>getExceptionByCode($code)</methodname> erlaubt es, alle Ausnahmen
|
|
|
mit einem speziellen Code vom Stack zu erhalten. <constant>FALSE</constant> wird
|
|
|
- zurückgegeben wenn keine gefunden wurden, und andernfalls ein Array mit
|
|
|
+ zurückgegeben, wenn keine gefunden wurden, und andernfalls ein Array mit
|
|
|
Ausnahmen.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>renderExceptions($flag)</methodname> erlaubt es ein Flag zu setzen
|
|
|
- das anzeigt ob die Ausnahmen ausgegeben werden sollen wenn die Antwort gesendet
|
|
|
- wurde, oder nicht.
|
|
|
+ <methodname>renderExceptions($flag)</methodname> erlaubt es ein Flag zu setzen,
|
|
|
+ das anzeigt, ob die Ausnahmen ausgegeben werden sollen, wenn die Antwort gesendet
|
|
|
+ wurde oder nicht.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.controller.response.subclassing">
|
|
|
- <title>Erben vom Antwort Objekt</title>
|
|
|
+ <title>Erben vom Response-Objekt</title>
|
|
|
|
|
|
<para>
|
|
|
- Der Zweck des Antwort Objekts ist es Header und Inhalte von den verschiedenen Aktionen
|
|
|
+ Der Zweck des Response-Objekts ist es, Header und Inhalte von den verschiedenen Aktionen
|
|
|
und Plugins zu sammeln und diese an den Client zurückzugeben; zweitens sammelt es in der
|
|
|
- Reihenfolge Ihres auftretens alle Fehler (Ausnahmen), und gibt diese zurück, oder
|
|
|
- versteckt Sie vor dem Endbenutzer.
|
|
|
+ Reihenfolge ihres Auftretens alle Fehler (Ausnahmen) und gibt diese zurück oder
|
|
|
+ versteckt sie vor dem Endbenutzer.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Die Basis Antwort Klasse ist <classname>Zend_Controller_Response_Abstract</classname>,
|
|
|
- und jede erbende Klasse die erstellt wird sollte von dieser Klasse oder eine Ihrer
|
|
|
- Derivate erben. Die verschiedenen vorhandenen Methoden wurden in der vorhergehenden
|
|
|
- Sektion aufgezählt.
|
|
|
+ Die Basis-Antwortklasse ist <classname>Zend_Controller_Response_Abstract</classname>,
|
|
|
+ und jede erbende Klasse, die erstellt wird, sollte von dieser Klasse oder eine ihrer
|
|
|
+ Derivate erben. Die verschiedenen vorhandenen Methoden wurden im vorhergehenden
|
|
|
+ Abschnitt aufgezählt.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Gründe um vom Antwort Objekt eine Subklasse zu erstellen beinhalten das Ändern wie eine
|
|
|
+ Die Gründe eine Subklasse des Response-Objekts zu erstellen beinhalten das Ändern wie eine
|
|
|
Ausgabe zurückgegeben wird, basierend auf der Antwortumgebung (z.B., keine Header senden
|
|
|
- für <acronym>CLI</acronym> oder <acronym>PHP</acronym>-<acronym>GTK</acronym> Anfragen),
|
|
|
- zusätzliche Funktionalitäten um eine endgültige Ansicht zurückzugeben, basierend am
|
|
|
- Inhalt der in den benannten Segmenten gespeichert wurde, usw.
|
|
|
+ für <acronym>CLI</acronym> oder <acronym>PHP</acronym>-<acronym>GTK</acronym>-Anfragen),
|
|
|
+ zusätzliche Funktionalitäten um eine endgültige Ansicht zurückzugeben, basierend auf
|
|
|
+ Inhalt, der in benannten Segmenten gespeichert wurde, usw.
|
|
|
</para>
|
|
|
</sect2>
|
|
|
</sect1>
|