de.osci.osci12.messageparts
Class Content

java.lang.Object
  de.osci.osci12.messageparts.MessagePart
      de.osci.osci12.messageparts.Content

public class Content

extends MessagePart

Die Content-Klasse repräsentiert einen Content-Eintrag in einer OSCI- Nachricht. Die Content-Einträge befinden sich in ContentContainer-Einträgen und enthalten die eigentlichen Inhaltsdaten, die in beliebigen Daten, Refenrenzen auf Attachments oder wiederum in Inhaltsdatencontainern bestehen können.

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

Field Summary

static int	ATTACHMENT_REFERENCE
static int	CONTENT_CONTAINER
static int	DATA

Fields inherited from class de.osci.osci12.messageparts.MessagePart

ns

Constructor Summary

Content(Attachment attachment)
Legt ein Content-Objekt an, welches eine Referenz auf ein Attachment enthält.

Content(ContentContainer contentContainer)
Legt ein Content-Objekt an, welches ein ContentContainer-Objekt enthält.

Content(java.io.InputStream ins)
Legt ein Content-Objekt an.

Content(java.io.InputStream ins, java.lang.String[] transformer, java.io.InputStream transformedData)
Legt ein Content-Objekt an.

Content(java.lang.String data)
Legt ein Content-Objekt mit dem Inhalt des übergebenen Strings an.

Content(java.lang.String data, java.lang.String[] transformer, java.lang.String transformedData)
Legt ein Content-Objekt mit dem Inhalt des übergebenen Strings an.

Method Summary

Attachment	getAttachment() Liefert das referenzierte Attachment zurück.
ContentContainer	getContentContainer() Liefert den Inhaltsdatencontainer zurück.
java.lang.String	getContentData() Liefert die eingestellten Daten des Content als String zurück.
java.io.InputStream	getContentStream() Liefert den InputStream der Daten zurück, wenn der Content einer empfangenen Nachricht entnommen wurde.
int	getContentType() Gibt die Art des Inhalts des Content-Objektes in Form eines Identifiers zurück.
java.lang.String[]	getTransformerForSignature() Liefert die Transformereinträge in der Signatur.
void	setTransformedData(java.io.InputStream transformedData) Bevor eine Signaturprüfung an dem ContentContainer-Objekt durchgeführt werden kann, welches dieses Content-Objekt enthält, müssen mit dieser Methode die transformierten Daten übergeben werden.
void	setTransformedData(java.lang.String transformedData) Bevor eine Signaturprüfung an dem ContentContainer-Objekt durchgeführt werden kann, welches dieses Content-Objekt enthält, müssen mit dieser Methode die transformierten Daten übergeben werden.
java.lang.String	toString() undocumented
void	writeXML(java.io.OutputStream out, boolean inner) Interne Methode, wird von Anwendungen normalerweise nicht aufgerufen.

Methods inherited from class de.osci.osci12.messageparts.MessagePart

getLength, getRefID, setNSPrefixes, setNSPrefixes, setRefID

Methods inherited from class java.lang.Object

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

Field Detail

ATTACHMENT_REFERENCE

public static final int ATTACHMENT_REFERENCE

See Also:

Constant Field Values

CONTENT_CONTAINER

public static final int CONTENT_CONTAINER

See Also:

Constant Field Values

DATA

public static final int DATA

See Also:

Constant Field Values

Constructor Detail

Content

public Content(java.io.InputStream ins)
        throws java.io.IOException

Legt ein Content-Objekt an. Die Daten werden aus dem übergebenen InputStream gelesen.

Parameters:

ins - InputStream

Throws:

java.io.IOException - bei Lesefehlern

Content

public Content(java.io.InputStream ins,
               java.lang.String[] transformer,
               java.io.InputStream transformedData)
        throws java.io.IOException,
               OSCIException,
               java.security.NoSuchAlgorithmException

Legt ein Content-Objekt an. Die Daten werden aus dem übergebenen InputStream gelesen. Übergebene Transformer-Strings werden in die XML-Signatur eingetragen, die Strings müssen die gesamten Transformer-Einträge gemäß der XML-Signature-Spezifikation in kanonischer Form enthalten. Die zu signierenden transformierten Daten werden aus dem als dritten Parameter übergebenen Stream gelesen.

Parameters:

ins - InputStream der Inhaltsdaten

transformer - Array der Transformereinträge

transformedData - InputStream der transformierten Daten

Throws:

java.io.IOException - bei Lesefehlern

OSCIException - bei Problemn beim Aufbau des OSCI-Signatureintrags

java.security.NoSuchAlgorithmException - wenn der verwendete Security-Provider den erforderlichen Hash-Algorithmus nicht unterstützt.

Content

public Content(java.lang.String data)
        throws java.io.IOException

Legt ein Content-Objekt mit dem Inhalt des übergebenen Strings an.

Parameters:

data - der Inhalt

Content

public Content(java.lang.String data,
               java.lang.String[] transformer,
               java.lang.String transformedData)
        throws java.io.IOException,
               OSCIException,
               java.security.NoSuchAlgorithmException

Legt ein Content-Objekt mit dem Inhalt des übergebenen Strings an. Übergebene Transformer-Strings werden in die XML-Signatur eingetragen, die Strings müssen die gesamten Transformer-Einträge gemäß der XML-Signature-Spezifikation in kanonischer Form enthalten. Die zu signierenden transformierten Daten müssen in dem als dritten Parameter übergebenen String enthalten sein.

Parameters:

data - Inhaltsdaten

transformer - Array der Transformereinträge

transformedData - String mit den transformierten Daten

Throws:

java.io.IOException - bei Lesefehlern

OSCIException - bei Problemn beim Aufbau des OSCI-Signatureintrags

java.security.NoSuchAlgorithmException - wenn der verwendete Security-Provider den erforderlichen Hash-Algorithmus nicht unterstützt.

Content

public Content(Attachment attachment)

Legt ein Content-Objekt an, welches eine Referenz auf ein Attachment enthält.

Parameters:

attachment - das Attachmentobjekt

Content

public Content(ContentContainer contentContainer)

Legt ein Content-Objekt an, welches ein ContentContainer-Objekt enthält. Eine solche Verschachtelung von ContentContainern ist z.B. für serielle Signaturen erforderlich.

Parameters:

contentContainer - der Inhaltsdatencontainer

Method Detail

setTransformedData

public void setTransformedData(java.io.InputStream transformedData)

Bevor eine Signaturprüfung an dem ContentContainer-Objekt durchgeführt werden kann, welches dieses Content-Objekt enthält, müssen mit dieser Methode die transformierten Daten übergeben werden. Dies betrifft nur Content-Objekte, die unter Anwendung von Transformationen signiert wurden.

Parameters:

transformedData - transformierte Daten

See Also:

setTransformedData(String transformedData), ContentContainer.checkSignature(de.osci.osci12.roles.Role)

setTransformedData

public void setTransformedData(java.lang.String transformedData)

Bevor eine Signaturprüfung an dem ContentContainer-Objekt durchgeführt werden kann, welches dieses Content-Objekt enthält, müssen mit dieser Methode die transformierten Daten übergeben werden. Dies betrifft nur Content-Objekte, die unter Anwendung von Transformationen signiert wurden.

Parameters:

transformedData - transformierte Daten

See Also:

setTransformedData(InputStream transformedData), ContentContainer.checkSignature(de.osci.osci12.roles.Role)

getTransformerForSignature

public java.lang.String[] getTransformerForSignature()

Liefert die Transformereinträge in der Signatur.

Returns:

String-Array mit den Transformereinträgen

getContentStream

public java.io.InputStream getContentStream()
                                     throws java.io.IOException

Liefert den InputStream der Daten zurück, wenn der Content einer empfangenen Nachricht entnommen wurde.

Returns:

den InputStream der Inhaltsdaten, oder null, wenn die Nachricht einen ContentContainer oder eine Attachmentreferenz enthält.

Throws:

java.io.IOException - bei Lesefehlern

getContentData

public java.lang.String getContentData()
                                throws java.io.IOException

Liefert die eingestellten Daten des Content als String zurück.

Returns:

den String der Inhaltsdaten oder null, wenn die Nachricht einen ContentContainer oder eine Attachmentreferenz enthält

Throws:

java.io.IOException - bei Lesefehlern

getAttachment

public Attachment getAttachment()

Liefert das referenzierte Attachment zurück.

Returns:

Attachment-Objekt oder null, wenn das Content-Objekt Nutzdaten oder einen Inhaltsdatencontainern enthält

getContentContainer

public ContentContainer getContentContainer()

Liefert den Inhaltsdatencontainer zurück.

Returns:

ContentContainer-Objekt oder null, wenn das Content-Objekt Nutzdaten oder eine Referenz auf ein Attachment enthält

getContentType

public int getContentType()

Gibt die Art des Inhalts des Content-Objektes in Form eines Identifiers zurück. Mögliche Werte sind ATTACHMENT_REFERENCE, CONTENT_CONTAINER und DATA

Returns:

Inhaltstyp

toString

public java.lang.String toString()

undocumented

Returns:

undocumented

writeXML

public void writeXML(java.io.OutputStream out,
                     boolean inner)
              throws java.io.IOException,
                     OSCIException

Interne Methode, wird von Anwendungen normalerweise nicht aufgerufen.

Parameters:

out -

Throws:

java.io.IOException

OSCIException