de.osci.osci12.messagetypes
Class ForwardDelivery

java.lang.Object
  de.osci.osci12.messagetypes.OSCIMessage
      de.osci.osci12.messagetypes.OSCIRequest
          de.osci.osci12.messagetypes.ForwardDelivery

All Implemented Interfaces:

ContentPackageI

public class ForwardDelivery

extends OSCIRequest

implements ContentPackageI

Mit dieser Klasse werden Nachrichtenobjekte für Weiterleitungsaufträge angelegt. Clients erhalten als Antwort auf diese Nachricht vom Intermediär ein ResponseToForwardDelivery-Nachrichtenobjekt, welches eine Rückmeldung über den Erfolg der Operation (getFeedback()) und ggf. den Laufzettel zur gesendeten Nachricht enthält.

Copyright © 2004 Freie Hansestadt Bremen

Erstellt von bremen online services Entwicklungs- und Betriebsgesellschaft GmbH & Co. KG

Diese Bibliothek kann von jedermann nach Maßgabe der Bremer Lizenz für freie Softwarebibliotheken genutzt werden.

Die Lizenzbestimmungen können unter der URL www.osci.de abgerufen oder bei der OSCI-Leitstelle, Senator für Finanzen, Freie Hansestadt Bremen, Postfach 10 15 40, 28015 Bremen schriftlich angefordert werden.

Version:

1.2.1

See Also:

ResponseToForwardDelivery

Field Summary

Fields inherited from class de.osci.osci12.messagetypes.OSCIMessage

ACCEPT_DELIVERY, attachments, contentContainer, contentID, controlBlock, desiredLanguagesH, dialogHandler, dsNSPrefix, encryptedData, EXIT_DIALOG, FETCH_DELIVERY, FETCH_PROCESS_CARD, FORWARD_DELIVERY, GET_MESSAGE_ID, hashableMsgPart, INIT_DIALOG, intermediaryCertificatesH, MEDIATE_DELIVERY, NO_SELECTION_RULE, nonIntermediaryCertificatesH, ns, osciNSPrefix, PROCESS_DELIVERY, qualityOfTimestampTypeCreation, qualityOfTimestampTypeReception, RESPONSE_TO_ACCEPT_DELIVERY, RESPONSE_TO_EXIT_DIALOG, RESPONSE_TO_FETCH_DELIVERY, RESPONSE_TO_FETCH_PROCESS_CARD, RESPONSE_TO_FORWARD_DELIVERY, RESPONSE_TO_GET_MESSAGE_ID, RESPONSE_TO_INIT_DIALOG, RESPONSE_TO_MEDIATE_DELIVERY, RESPONSE_TO_PROCESS_DELIVERY, RESPONSE_TO_STORE_DELIVERY, SELECT_ADDRESSEE, SELECT_ALL, SELECT_BY_DATE_OF_RECEPTION, SELECT_BY_MESSAGE_ID, SELECT_BY_RECENT_MODIFICATION, SELECT_ORIGINATOR, signatureHeader, SOAP_FAULT_MESSAGE, SOAP_MESSAGE_ENCRYPTED, soapNSPrefix, STORE_DELIVERY, TYPE_UNDEFINED, xencNSPrefix, xsiNSPrefix

Constructor Summary

ForwardDelivery(DialogHandler dh, Addressee addressee, java.lang.String uriReceiver, java.lang.String messageId)
Legt ein Nachrichtenobjekt für einen Weiterleitungsauftrag an.

Method Summary

void	addContentContainer(ContentContainer container) Fügt der Nachricht einen Inhaltsdatencontainer hinzu.
void	addEncryptedData(EncryptedDataOSCI encData) Fügt der Nachricht einen EncryptedData-Eintrag mit verschlüsselten Inhaltsdaten hinzu.
ContentContainer[]	getContentContainer() Liefert die in die Nachricht eingestellten (unverschlüsselten) Inhaltsdaten als ContentContainer-Objekte.
java.lang.String	getContentReceiver() Liefert die Adresse des Empfängers der Inhaltsdaten.
EncryptedDataOSCI[]	getEncryptedData() Liefert die in die Nachricht eingestellten verschlüsselten Inhaltsdaten als EncryptedData-Objekte.
java.lang.String	getMessageId() undocumented
boolean	getQualityOfTimeStampCreation() Liefert die Qualität des Zeitstempels, mit dem der Intermediär den Eingang des Auftrags im Laufzettel protokolliert.
boolean	getQualityOfTimeStampReception() Liefert die geforderte Qualität des Zeitstempels, mit dem der Intermediär den Empfang der Annahmeantwort im Laufzettel protokolliert.
java.lang.String	getSubject() Liefert den Betreff der Nachricht.
void	removeContentContainer(ContentContainer container) Entfernt einen Inhaltsdatencontainer aus der Nachricht.
void	removeEncryptedData(EncryptedDataOSCI encData) Entfernt einen EncryptedData-Eintrag mit verschlüsselten Daten aus der Nachricht.
ResponseToForwardDelivery	send() Versendet die Nachricht und liefert die Antwortnachricht zurück.
ResponseToForwardDelivery	send(java.io.OutputStream storeOutput, java.io.OutputStream storeInput) Versendet die Nachricht und liefert die Antwortnachricht zurück.
void	setContentReceiver(java.lang.String uri) Setzt die Adresse des Empfängers der Inhaltsdaten.
void	setQualityOfTimeStampCreation(boolean cryptographic) Setzt die gewünschte Qualität des Zeitstempels, mit dem der Intermediär den Eingang des Auftrags im Laufzettel protokolliert.
void	setQualityOfTimeStampReception(boolean cryptographic) Setzt die gewünschte Qualität des Zeitstempels, mit dem der Intermediär den Empfang der Annahmeantwort im Laufzettel protokolliert.
void	setSubject(java.lang.String subject) Setzt den Betreff der Nachricht.

Methods inherited from class de.osci.osci12.messagetypes.OSCIRequest

getDesiredLanguages

Methods inherited from class de.osci.osci12.messagetypes.OSCIMessage

addCustomHeader, addRole, formatISO8601, getAddressee, getBase64Encoding, getCustomHeaders, getDialogHandler, getMessageType, getOriginator, getOtherAuthors, getOtherReaders, getRoleForRefID, isSigned, parseISO8601, setBase64Encoding, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ForwardDelivery

public ForwardDelivery(DialogHandler dh,
                       Addressee addressee,
                       java.lang.String uriReceiver,
                       java.lang.String messageId)
                throws java.net.URISyntaxException,
                       java.security.NoSuchAlgorithmException

Legt ein Nachrichtenobjekt für einen Weiterleitungsauftrag an.

Parameters:

dh - DialogHandler-Objekt des Dialogs, innerhalb dessen die Nachricht versendet werden soll

addressee - Rollenobjekt des Empfängers

uriReceiver - URI des adressierten Empfängers

messageId - Message-Id der Nachricht

Throws:

java.net.URISyntaxException - bei ungültiger URI

java.security.NoSuchAlgorithmException - wenn der verwendete Security-Provider einen erforderlichen Algorithmus nicht unterstützt (Erzeugung einer Zufallszahl)

See Also:

DialogHandler

Method Detail

send

public ResponseToForwardDelivery send()
                               throws java.io.IOException,
                                      OSCIException,
                                      java.security.NoSuchAlgorithmException

Versendet die Nachricht und liefert die Antwortnachricht zurück. Diese Methode wirft eine Exception, wenn beim Aufbau oder Versand der Nachricht ein Fehler auftritt. Fehlermeldungen vom Intermediär müssen dem Feedback der Antwortnachricht entnommen werden.

Returns:

Antwortnachricht-Objekt

Throws:

java.io.IOException - bei Ein-/Ausgabefehlern

OSCIException - bei OSCI-Fehlern

java.security.NoSuchAlgorithmException

See Also:

send(OutputStream, OutputStream)

send

public ResponseToForwardDelivery send(java.io.OutputStream storeOutput,
                                      java.io.OutputStream storeInput)
                               throws java.io.IOException,
                                      OSCIException,
                                      java.security.NoSuchAlgorithmException

Versendet die Nachricht und liefert die Antwortnachricht zurück. Die aus- und eingehenden Daten werden zusätzlich in die übergebenen Streams geschrieben (unverschlüsselte Auftragsdaten). Diese Parameter dürfen null sein.

Parameters:

storeOutput - Stream, in den die versendete Nachricht geschrieben wird

storeInput - Stream, in den die empfangene Antwortnachricht geschrieben wird

Returns:

Antwortnachricht-Objekt

Throws:

java.io.IOException - bei Ein-/Ausgabefehlern

OSCIException - bei OSCI-Fehlern

java.security.NoSuchAlgorithmException

See Also:

send()

setQualityOfTimeStampCreation

public void setQualityOfTimeStampCreation(boolean cryptographic)

Setzt die gewünschte Qualität des Zeitstempels, mit dem der Intermediär den Eingang des Auftrags im Laufzettel protokolliert.

Parameters:

cryptographic - true: kryptographischer Zeitstempel von einem akkreditierten Zeitstempeldienst
false: Einfacher Zeitstempel (lokale Rechnerzeit des Intermediärs, default)

See Also:

getQualityOfTimeStampCreation()

getQualityOfTimeStampCreation

public boolean getQualityOfTimeStampCreation()

Liefert die Qualität des Zeitstempels, mit dem der Intermediär den Eingang des Auftrags im Laufzettel protokolliert.

Returns:

Qualität des Zeitstempels: true - kryptographischer Zeitstempel von einem akkreditierten Zeitstempeldienst
false - Einfacher Zeitstempel (lokale Rechnerzeit des Intermediärs)

See Also:

setQualityOfTimeStampCreation(boolean)

setQualityOfTimeStampReception

public void setQualityOfTimeStampReception(boolean cryptographic)

Setzt die gewünschte Qualität des Zeitstempels, mit dem der Intermediär den Empfang der Annahmeantwort im Laufzettel protokolliert.

Parameters:

cryptographic - true: kryptographischer Zeitstempel von einem akkreditierten Zeitstempeldienst
false: Einfacher Zeitstempel (lokale Rechnerzeit des Intermediärs, default)

See Also:

getQualityOfTimeStampReception()

getQualityOfTimeStampReception

public boolean getQualityOfTimeStampReception()

Liefert die geforderte Qualität des Zeitstempels, mit dem der Intermediär den Empfang der Annahmeantwort im Laufzettel protokolliert.

Returns:

Qualität des Zeitstempels: true - kryptographischer Zeitstempel von einem akkreditierten Zeitstempeldienst
false - Einfacher Zeitstempel (lokale Rechnerzeit des Intermediärs)

See Also:

setQualityOfTimeStampReception(boolean)

getContentReceiver

public java.lang.String getContentReceiver()

Liefert die Adresse des Empfängers der Inhaltsdaten.

Returns:

Adresse (URI)

setContentReceiver

public void setContentReceiver(java.lang.String uri)
                        throws java.net.URISyntaxException

Setzt die Adresse des Empfängers der Inhaltsdaten.

Parameters:

uri - Adresse

Throws:

java.net.URISyntaxException - bei Syntaxfehlern

getSubject

public java.lang.String getSubject()

Liefert den Betreff der Nachricht.

Specified by:

getSubject in interface ContentPackageI

Returns:

den Betreff der Zustellung

setSubject

public void setSubject(java.lang.String subject)

Setzt den Betreff der Nachricht. Der übergebene Parameter-String muß den Vorschriften für den primitiven XML-Datentyp "string" entsprechen, darf also z.B. keine XML-Steuerzeichen (<, > o.ä.) enthalten.

Parameters:

subject - Betreff

addContentContainer

public void addContentContainer(ContentContainer container)
                         throws OSCIRoleException

Fügt der Nachricht einen Inhaltsdatencontainer hinzu. Diese Methode sollte erst aufgerufen werden, wenn der Container vollständig erstellt wurde.

Parameters:

container - Inhaltsdatencontainer

Throws:

OSCIRoleException

See Also:

ContentContainer

removeContentContainer

public void removeContentContainer(ContentContainer container)

Entfernt einen Inhaltsdatencontainer aus der Nachricht.

Parameters:

container - Inhaltsdatencontainer

See Also:

addContentContainer(de.osci.osci12.messageparts.ContentContainer)

getContentContainer

public ContentContainer[] getContentContainer()

Liefert die in die Nachricht eingestellten (unverschlüsselten) Inhaltsdaten als ContentContainer-Objekte.

Specified by:

getContentContainer in interface ContentPackageI

Returns:

enthaltene ContentContainer mit Inhaltsdaten

See Also:

ContentContainer

addEncryptedData

public void addEncryptedData(EncryptedDataOSCI encData)
                      throws OSCIRoleException

Fügt der Nachricht einen EncryptedData-Eintrag mit verschlüsselten Inhaltsdaten hinzu.

Parameters:

encData - verschlüsselte Daten

Throws:

OSCIRoleException

See Also:

EncryptedDataOSCI

removeEncryptedData

public void removeEncryptedData(EncryptedDataOSCI encData)

Entfernt einen EncryptedData-Eintrag mit verschlüsselten Daten aus der Nachricht.

Parameters:

encData - verschlüsselte Daten

See Also:

addEncryptedData(de.osci.osci12.messageparts.EncryptedDataOSCI), EncryptedDataOSCI

getEncryptedData

public EncryptedDataOSCI[] getEncryptedData()

Liefert die in die Nachricht eingestellten verschlüsselten Inhaltsdaten als EncryptedData-Objekte.

Specified by:

getEncryptedData in interface ContentPackageI

Returns:

enthaltene EncryptedData-Objekt mit verschlüsselten Inhaltsdaten

See Also:

EncryptedDataOSCI

getMessageId

public java.lang.String getMessageId()

undocumented

Specified by:

getMessageId in interface ContentPackageI

Returns:

undocumented