net.wimpi.pim.contact.model
Interface Image

All Superinterfaces:

java.io.Serializable

All Known Implementing Classes:

DataContainer

public interface Image

extends java.io.Serializable

An interface modeling an image based on the types and information of the vCard Mime directory profile standard specification.

For reference see RFC 2426:
3.1.4 PHOTO Type Definition
3.5.3 LOGO Type Definition

Note that an Image might be either inlined as encoded binary data (MimeBase64 Encoding) or represented by an URI reference.
Should refer to or contain data of an IANA registered image format for maximum compatibility.

Version:

0.1 (22/07/2003)

Author:

Dieter Wimberger

Method Summary

java.lang.String	getContentType() Returns the content type of this Image.
byte[]	getData() Returns the non-encoded binary data representing this Image.
byte[]	getDataFromURI() Returns the data obtained from the uri of this Image.
java.io.InputStream	getInputStream() Returns an InputStream providing access to the data of this Image.
java.lang.String	getURI() Returns the URI reference representing this Image.
boolean	isData() Tests if this Image is given as binary data.
boolean	isURI() Tests if this Image is given as an URI reference.
void	setContentType(java.lang.String ctype) Sets the content type of this Image.
void	setData(byte[] data) Sets the non-encoded binary data representing this Image.
void	setData(java.lang.String uri) Sets the non-encoded binary data as obtained from the given uri.
void	setURI(java.lang.String uri) Sets the URI reference representing this Image.

Method Detail

isURI

public boolean isURI()

Tests if this Image is given as an URI reference.

Returns:

true if given as URI, false otherwise.

getURI

public java.lang.String getURI()

Returns the URI reference representing this Image.

Returns:

the URI reference as String.

setURI

public void setURI(java.lang.String uri)

Sets the URI reference representing this Image.

Parameters:

uri - the URI reference as String.

isData

public boolean isData()

Tests if this Image is given as binary data.

Returns:

true if given as binary data, false otherwise.

getContentType

public java.lang.String getContentType()

Returns the content type of this Image.

Returns:

the content type as String.

setContentType

public void setContentType(java.lang.String ctype)

Sets the content type of this Image.

Parameters:

ctype - the content type as String.

getData

public byte[] getData()

Returns the non-encoded binary data representing this Image.

Returns:

the non-encoded binary data as byte[].

setData

public void setData(byte[] data)

Sets the non-encoded binary data representing this Image.

Parameters:

data - the non-encoded binary data as byte[].

setData

public void setData(java.lang.String uri)
             throws java.io.IOException,
                    java.net.MalformedURLException

Sets the non-encoded binary data as obtained from the given uri.

Parameters:

uri - an URI as String.

java.io.IOException

java.net.MalformedURLException

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException,
                                          java.net.MalformedURLException

Returns an InputStream providing access to the data of this Image.

An implementation might use a ByteArrayInputStream for inlined data, or return the input stream which can be obtained from the URI (i.e. using java.net.URL).

Returns:

an InputStream instance.

java.io.IOException

java.net.MalformedURLException

getDataFromURI

public byte[] getDataFromURI()
                      throws java.io.IOException,
                             java.net.MalformedURLException

Returns the data obtained from the uri of this Image.

Returns:

a byte[].

java.io.IOException

java.net.MalformedURLException