org.eclipse.soda.dk.device.servlet
Class DeviceServletContext

java.lang.Object
  org.eclipse.soda.dk.device.servlet.DeviceServletContext

Direct Known Subclasses:

DeviceBundleServletContext, DeviceConfigurationServletContext, DeviceDeviceServletContext, DeviceMetadataServletContext, DevicePropertyServletContext, DeviceServiceServletContext

public class DeviceServletContext
extends java.lang.Object

Version:

1.1.0

Field Summary

java.util.Map	contentTypes Define the content types (Map) field.
protected java.lang.String	fileExtension Define the file extension (String) field.
protected java.lang.String	fileName Define the file name (String) field.
protected java.lang.String	filePath Define the file path (String) field.
protected boolean	filterId Define the filter id (boolean) field.
protected java.lang.String	firstItem Define the first item (String) field.
static char[]	HEX_CHAR_LOWER_TABLE Define the hex char lower table (char[]) constant.
static char[]	HEX_CHAR_UPPER_TABLE Define the hex char upper table (char[]) constant.
static java.lang.String	HTML_CONTENT_TYPE Define the html content type (String) constant.
protected long	idEnd Define the id end (long) field.
protected long	idStart Define the id start (long) field.
protected java.lang.String	path Define the path translated (String) field.
protected javax.servlet.http.HttpServletRequest	request Define the request (HttpServletRequest) field.
protected javax.servlet.http.HttpServletResponse	response Define the response (HttpServletResponse) field.
protected java.lang.String	serverAlias Define the server alias (String) field.
protected java.lang.String	simpleFilePath Define the simple file path (String) field.
static java.lang.String	TXT_CONTENT_TYPE Define the txt content type (String) constant.
static java.lang.String	XML_CONTENT_TYPE Define the xml content type (String) constant.

Constructor Summary

DeviceServletContext(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, java.lang.String serverAlias)

Method Summary

void	addEntities(java.util.Dictionary map)
void	addEntities(java.util.Map map)
void	addEntity(java.lang.String key, java.lang.Object value)
void	addEntityBundle(org.osgi.framework.Bundle bundle)
void	addEntityIcon(java.lang.String key, java.lang.String iconName)
void	addEntityServiceReference(org.osgi.framework.ServiceReference serviceReference) Add entity service reference with the specified service reference parameter.
void	begin() Begin.
void	end() End.
boolean	filter(org.osgi.framework.Bundle bundle)
org.osgi.framework.Bundle[]	filter(org.osgi.framework.Bundle[] bundles)
boolean	filter(long id)
boolean	filter(org.osgi.framework.ServiceReference serviceReference) Filter with the specified service reference parameter and return the boolean result.
org.osgi.framework.ServiceReference[]	filter(org.osgi.framework.ServiceReference[] serviceReferences) Filter with the specified service references parameter and return the ServiceReference[] result.
boolean	filter(java.lang.String url)
int	findBestLanguage(java.lang.String language, java.lang.String[] languages)
java.lang.String	findIcon(java.lang.String iconName)
java.lang.String	formatData(java.lang.Object data)
void	formatData(java.lang.StringBuffer buffer, java.lang.Object data)
java.lang.String	formatDataShort(java.lang.Object data)
org.osgi.framework.BundleContext	getBundleContext() Gets the bundle context value.
java.lang.String	getBundleDescription() Gets the bundle description (String) value.
java.lang.String	getBundleName() Gets the bundle name (String) value.
java.lang.String	getBundleSymbolicName() Gets the bundle symbolic name (String) value.
java.lang.String	getCopyright() Gets the copyright (String) value.
java.util.Map	getEntities() Gets the entities (Map) value.
java.lang.String	getEntity(java.lang.String key)
java.util.Hashtable	getFactoryMetadata() Gets the factory metadata (Hashtable) value.
java.lang.String	getFileExtension() Gets the file extension (String) value.
java.lang.String	getFileName() Gets the file name (String) value.
java.lang.String	getFilePath() Gets the file path (String) value.
java.lang.String	getFirstItem() Gets the first item (String) value.
java.lang.String	getHostAddress() Gets the host address (String) value.
java.util.Map	getIcons() Gets the icons (Hashtable) value.
long	getIdEnd() Gets the id end (long) value.
long	getIdStart() Gets the id start (long) value.
java.lang.String	getInputDirectory() Gets the input directory (String) value.
java.lang.String	getLanguage() Gets the language (String) value.
java.lang.String	getPath() Gets the path (String) value.
java.util.Hashtable	getPidMetadata() Gets the pid metadata (Hashtable) value.
java.lang.String	getProvider() Gets the provider (String) value.
javax.servlet.http.HttpServletRequest	getRequest() Gets the request (HttpServletRequest) value.
java.util.Map	getResourceLocations() Gets the resource locations (Map) value.
javax.servlet.http.HttpServletResponse	getResponse() Gets the response (HttpServletResponse) value.
java.lang.String	getServerAlias() Gets the server alias (String) value.
java.lang.String	getShort(java.lang.Object data)
java.lang.String	getSimpleFilePath() Gets the simple file path (String) value.
java.lang.Object	getTitle() Gets the title (Object) value.
java.lang.Object	getVendor() Gets the vendor (Object) value.
java.lang.Object	getVendors() Gets the vendors (Object) value.
java.lang.String	getVersion() Gets the version (String) value.
java.io.PrintWriter	getWriter() Gets the writer (PrintWriter) value.
java.lang.String	getYear() Gets the year (String) value.
java.lang.String	getYears() Gets the years (String) value.
boolean	isFilterId() Gets the filter id (boolean) value.
java.lang.String	niceIconNane(java.lang.String name)
void	print(int data)
void	print(java.lang.String data)
void	println(java.lang.String data)
boolean	respondWith(java.net.URL url)
void	setBundleContext(org.osgi.framework.BundleContext bundleContext) Sets the bundle context value.
void	setEntities(java.util.Hashtable entities)
void	setFactoryMetadata(java.util.Hashtable factoryMetadata)
void	setFileExtension(java.lang.String fileExtension)
void	setFileName(java.lang.String fileName)
void	setFilePath(java.lang.String filePath)
void	setFilterId(boolean filterId)
void	setFirstItem(java.lang.String firstItem)
void	setIcons(java.util.Hashtable icons)
void	setIdEnd(long idEnd)
void	setIdStart(long idStart)
void	setLanguage(java.lang.String lanuguage)
void	setPath(java.lang.String path)
void	setPidMetadata(java.util.Hashtable pidMetadata)
void	setRequest(javax.servlet.http.HttpServletRequest request)
void	setResourceLocations(java.util.Hashtable resourceLocations)
void	setResponse(javax.servlet.http.HttpServletResponse response)
void	setServerAlias(java.lang.String serverAlias)
void	setSimpleFilePath(java.lang.String simpleFilePath) Sets the simple file path value.
void	setupEntities() Setup entities.
void	setupRequest(javax.servlet.http.HttpServletRequest request)
void	setupResponse(javax.servlet.http.HttpServletResponse response)
void	setWriter(java.io.PrintWriter writer)
void	sort(org.osgi.framework.Bundle[] bundles)
void	sort(org.osgi.framework.ServiceReference[] serviceReferences)
void	sort(java.lang.String[] strings)
void	template(java.lang.String name)
java.io.InputStream	templateInputStream(java.lang.String name)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

HEX_CHAR_LOWER_TABLE

public static final char[] HEX_CHAR_LOWER_TABLE

Define the hex char lower table (char[]) constant.

HEX_CHAR_UPPER_TABLE

public static final char[] HEX_CHAR_UPPER_TABLE

Define the hex char upper table (char[]) constant.

HTML_CONTENT_TYPE

public static final java.lang.String HTML_CONTENT_TYPE

Define the html content type (String) constant.

See Also:

Constant Field Values

TXT_CONTENT_TYPE

public static final java.lang.String TXT_CONTENT_TYPE

Define the txt content type (String) constant.

See Also:

Constant Field Values

XML_CONTENT_TYPE

public static final java.lang.String XML_CONTENT_TYPE

Define the xml content type (String) constant.

See Also:

Constant Field Values

contentTypes

public java.util.Map contentTypes

Define the content types (Map) field.

serverAlias

protected java.lang.String serverAlias

Define the server alias (String) field.

request

protected javax.servlet.http.HttpServletRequest request

Define the request (HttpServletRequest) field.

response

protected javax.servlet.http.HttpServletResponse response

Define the response (HttpServletResponse) field.

path

protected java.lang.String path

Define the path translated (String) field.

firstItem

protected java.lang.String firstItem

Define the first item (String) field.

filePath

protected java.lang.String filePath

Define the file path (String) field.

simpleFilePath

protected java.lang.String simpleFilePath

Define the simple file path (String) field.

fileName

protected java.lang.String fileName

Define the file name (String) field.

fileExtension

protected java.lang.String fileExtension

Define the file extension (String) field.

idStart

protected long idStart

Define the id start (long) field.

idEnd

protected long idEnd

Define the id end (long) field.

filterId

protected boolean filterId

Define the filter id (boolean) field.

Constructor Detail

DeviceServletContext

public DeviceServletContext(javax.servlet.http.HttpServletRequest request,
                            javax.servlet.http.HttpServletResponse response,
                            java.lang.String serverAlias)

Parameters:

request - The request (HttpServletRequest) parameter.

response - The response (HttpServletResponse) parameter.

serverAlias - The server alias (String) parameter.

Method Detail

addEntities

public void addEntities(java.util.Dictionary map)

Parameters:

map - The map (Dictionary) parameter.

See Also:

addEntities(Map), getEntities(), setEntities(Hashtable), setupEntities()

addEntities

public void addEntities(java.util.Map map)

Parameters:

map - The map (Map) parameter.

See Also:

addEntities(Dictionary), getEntities(), setEntities(Hashtable), setupEntities()

addEntity

public void addEntity(java.lang.String key,
                      java.lang.Object value)

Parameters:

key - The key (String) parameter.

value - The value (Object) parameter.

See Also:

getEntity(String)

addEntityBundle

public void addEntityBundle(org.osgi.framework.Bundle bundle)

Parameters:

bundle - The bundle (Bundle) parameter.

addEntityIcon

public void addEntityIcon(java.lang.String key,
                          java.lang.String iconName)

Parameters:

key - The key (String) parameter.

iconName - The icon name (String) parameter.

addEntityServiceReference

public void addEntityServiceReference(org.osgi.framework.ServiceReference serviceReference)

Add entity service reference with the specified service reference parameter. The service reference (ServiceReference) parameter.

Parameters:

serviceReference - The service reference (ServiceReference) parameter.

begin

public void begin()

Begin.

end

public void end()

End.

filter

public boolean filter(org.osgi.framework.Bundle bundle)

Parameters:

bundle - The bundle (Bundle) parameter.

Returns:

Results of the filter (boolean) value.

See Also:

filter(String), filter(long), filter(Bundle[]), filter(ServiceReference), filter(ServiceReference[])

filter

public org.osgi.framework.Bundle[] filter(org.osgi.framework.Bundle[] bundles)

Parameters:

bundles - The bundles (Bundle[]) parameter.

Returns:

Results of the filter (Bundle[]) value.

See Also:

filter(String), filter(long), filter(Bundle), filter(ServiceReference), filter(ServiceReference[])

filter

public boolean filter(long id)

Parameters:

id - The id (long) parameter.

Returns:

Results of the filter (boolean) value.

See Also:

filter(String), filter(Bundle), filter(Bundle[]), filter(ServiceReference), filter(ServiceReference[])

filter

public boolean filter(org.osgi.framework.ServiceReference serviceReference)

Filter with the specified service reference parameter and return the boolean result. The service reference (ServiceReference) parameter.

Parameters:

serviceReference - The service reference (ServiceReference) parameter.

Returns:

Results of the filter (boolean) value.

See Also:

filter(String), filter(long), filter(Bundle), filter(Bundle[]), filter(ServiceReference[])

filter

public org.osgi.framework.ServiceReference[] filter(org.osgi.framework.ServiceReference[] serviceReferences)

Filter with the specified service references parameter and return the ServiceReference[] result. The service references (ServiceReference[]) parameter.

Parameters:

serviceReferences - The service references (ServiceReference[]) parameter.

Returns:

Results of the filter (ServiceReference[]) value.

See Also:

filter(String), filter(long), filter(Bundle), filter(Bundle[]), filter(ServiceReference)

filter

public boolean filter(java.lang.String url)

Parameters:

url - The url (String) parameter.

Returns:

Results of the filter (boolean) value.

See Also:

filter(long), filter(Bundle), filter(Bundle[]), filter(ServiceReference), filter(ServiceReference[])

findBestLanguage

public int findBestLanguage(java.lang.String language,
                            java.lang.String[] languages)

Parameters:

language - The language (String) parameter.

languages - The languages (String[]) parameter.

Returns:

Results of the find best language (int) value.

findIcon

public java.lang.String findIcon(java.lang.String iconName)

Parameters:

iconName - The icon name (String) parameter.

Returns:

Results of the find icon (String) value.

See Also:

addEntityIcon(String,String)

formatData

public java.lang.String formatData(java.lang.Object data)

Parameters:

data - The data (Object) parameter.

Returns:

Results of the format data (String) value.

See Also:

formatData(StringBuffer,Object)

formatData

public void formatData(java.lang.StringBuffer buffer,
                       java.lang.Object data)

Parameters:

buffer - The buffer (StringBuffer) parameter.

data - The data (Object) parameter.

See Also:

formatData(Object)

formatDataShort

public java.lang.String formatDataShort(java.lang.Object data)

Parameters:

data - The data (Object) parameter.

Returns:

Results of the format data short (String) value.

getBundleContext

public org.osgi.framework.BundleContext getBundleContext()

Gets the bundle context value.

Returns:

The bundle context (BundleContext) value.

See Also:

setBundleContext(BundleContext)

getBundleDescription

public java.lang.String getBundleDescription()

Gets the bundle description (String) value.

Returns:

The bundle description (String) value.

getBundleName

public java.lang.String getBundleName()

Gets the bundle name (String) value.

Returns:

The bundle name (String) value.

getBundleSymbolicName

public java.lang.String getBundleSymbolicName()

Gets the bundle symbolic name (String) value.

Returns:

The bundle symbolic name (String) value.

getCopyright

public java.lang.String getCopyright()

Gets the copyright (String) value.

Returns:

The copyright (String) value.

getEntities

public java.util.Map getEntities()

Gets the entities (Map) value.

Returns:

The entities (Map) value.

See Also:

addEntities(Dictionary), addEntities(Map), setEntities(Hashtable), setupEntities()

getEntity

public java.lang.String getEntity(java.lang.String key)

Parameters:

key - The key (String) parameter.

Returns:

Results of the get entity (String) value.

See Also:

addEntity(String,Object)

getFactoryMetadata

public java.util.Hashtable getFactoryMetadata()

Gets the factory metadata (Hashtable) value.

Returns:

The factory metadata (Hashtable) value.

See Also:

setFactoryMetadata(Hashtable)

getFileExtension

public java.lang.String getFileExtension()

Gets the file extension (String) value.

Returns:

The file extension (String) value.

See Also:

setFileExtension(String)

getFileName

public java.lang.String getFileName()

Gets the file name (String) value.

Returns:

The file name (String) value.

See Also:

setFileName(String)

getFilePath

public java.lang.String getFilePath()

Gets the file path (String) value.

Returns:

The file path (String) value.

See Also:

getSimpleFilePath(), setFilePath(String), setSimpleFilePath(String)

getFirstItem

public java.lang.String getFirstItem()

Gets the first item (String) value.

Returns:

The first item (String) value.

See Also:

setFirstItem(String)

getHostAddress

public java.lang.String getHostAddress()

Gets the host address (String) value.

Returns:

The host address (String) value.

getIcons

public java.util.Map getIcons()

Gets the icons (Hashtable) value.

Returns:

The icons (Hashtable) value.

See Also:

setIcons(Hashtable)

getIdEnd

public long getIdEnd()

Gets the id end (long) value.

Returns:

The id end (long) value.

See Also:

setIdEnd(long)

getIdStart

public long getIdStart()

Gets the id start (long) value.

Returns:

The id start (long) value.

See Also:

setIdStart(long)

getInputDirectory

public java.lang.String getInputDirectory()

Gets the input directory (String) value.

Returns:

The input directory (String) value.

getLanguage

public java.lang.String getLanguage()

Gets the language (String) value.

Returns:

The language (String) value.

See Also:

findBestLanguage(String,String[]), setLanguage(String)

getPath

public java.lang.String getPath()

Gets the path (String) value.

Returns:

The path (String) value.

See Also:

getFilePath(), getSimpleFilePath(), setFilePath(String), setPath(String), setSimpleFilePath(String)

getPidMetadata

public java.util.Hashtable getPidMetadata()

Gets the pid metadata (Hashtable) value.

Returns:

The pid metadata (Hashtable) value.

See Also:

setPidMetadata(Hashtable)

getProvider

public java.lang.String getProvider()

Gets the provider (String) value.

Returns:

The provider (String) value.

getRequest

public javax.servlet.http.HttpServletRequest getRequest()

Gets the request (HttpServletRequest) value.

Returns:

The request (HttpServletRequest) value.

See Also:

setRequest(HttpServletRequest), setupRequest(HttpServletRequest)

getResourceLocations

public java.util.Map getResourceLocations()

Gets the resource locations (Map) value.

Returns:

The resource locations (Map) value.

See Also:

setResourceLocations(Hashtable)

getResponse

public javax.servlet.http.HttpServletResponse getResponse()

Gets the response (HttpServletResponse) value.

Returns:

The response (HttpServletResponse) value.

See Also:

setResponse(HttpServletResponse), setupResponse(HttpServletResponse)

getServerAlias

public java.lang.String getServerAlias()

Gets the server alias (String) value.

Returns:

The server alias (String) value.

See Also:

setServerAlias(String)

getShort

public java.lang.String getShort(java.lang.Object data)

Parameters:

data - The data (Object) parameter.

Returns:

Results of the get short (String) value.

See Also:

formatDataShort(Object)

getSimpleFilePath

public java.lang.String getSimpleFilePath()

Gets the simple file path (String) value.

Returns:

The simple file path (String) value.

See Also:

setSimpleFilePath(String)

getTitle

public java.lang.Object getTitle()

Gets the title (Object) value.

Returns:

The title (Object) value.

getVendor

public java.lang.Object getVendor()

Gets the vendor (Object) value.

Returns:

The vendor (Object) value.

getVendors

public java.lang.Object getVendors()

Gets the vendors (Object) value.

Returns:

The vendors (Object) value.

getVersion

public java.lang.String getVersion()

Gets the version (String) value.

Returns:

The version (String) value.

getWriter

public java.io.PrintWriter getWriter()

Gets the writer (PrintWriter) value.

Returns:

The writer (PrintWriter) value.

See Also:

setWriter(PrintWriter)

getYear

public java.lang.String getYear()

Gets the year (String) value.

Returns:

The year (String) value.

getYears

public java.lang.String getYears()

Gets the years (String) value.

Returns:

The years (String) value.

isFilterId

public boolean isFilterId()

Gets the filter id (boolean) value.

Returns:

The filter id (boolean) value.

See Also:

setFilterId(boolean)

niceIconNane

public java.lang.String niceIconNane(java.lang.String name)

Parameters:

name - The name (String) parameter.

Returns:

Results of the nice icon nane (String) value.

print

public void print(int data)

Parameters:

data - The data (int) parameter.

See Also:

print(String)

print

public void print(java.lang.String data)

Parameters:

data - The data (String) parameter.

See Also:

print(int)

println

public void println(java.lang.String data)

Parameters:

data - The data (String) parameter.

respondWith

public boolean respondWith(java.net.URL url)

Parameters:

url - The url (URL) parameter.

Returns:

Results of the respond with (boolean) value.

setBundleContext

public void setBundleContext(org.osgi.framework.BundleContext bundleContext)

Sets the bundle context value.

Parameters:

bundleContext - The bundle context (BundleContext) parameter.

See Also:

getBundleContext()

setEntities

public void setEntities(java.util.Hashtable entities)

Parameters:

entities - The entities (Hashtable) parameter.

See Also:

addEntities(Dictionary), addEntities(Map), getEntities(), setupEntities()

setFactoryMetadata

public void setFactoryMetadata(java.util.Hashtable factoryMetadata)

Parameters:

factoryMetadata - The factory metadata (Hashtable) parameter.

See Also:

getFactoryMetadata()

setFileExtension

public void setFileExtension(java.lang.String fileExtension)

Parameters:

fileExtension - The file extension (String) parameter.

See Also:

getFileExtension()

setFileName

public void setFileName(java.lang.String fileName)

Parameters:

fileName - The file name (String) parameter.

See Also:

getFileName()

setFilePath

public void setFilePath(java.lang.String filePath)

Parameters:

filePath - The file path (String) parameter.

See Also:

getFilePath(), getSimpleFilePath(), setSimpleFilePath(String)

setFilterId

public void setFilterId(boolean filterId)

Parameters:

filterId - The filter id (boolean) parameter.

See Also:

isFilterId()

setFirstItem

public void setFirstItem(java.lang.String firstItem)

Parameters:

firstItem - The first item (String) parameter.

See Also:

getFirstItem()

setIcons

public void setIcons(java.util.Hashtable icons)

Parameters:

icons - The icons (Hashtable) parameter.

See Also:

getIcons()

setIdEnd

public void setIdEnd(long idEnd)

Parameters:

idEnd - The id end (long) parameter.

See Also:

getIdEnd()

setIdStart

public void setIdStart(long idStart)

Parameters:

idStart - The id start (long) parameter.

See Also:

getIdStart()

setLanguage

public void setLanguage(java.lang.String lanuguage)

Parameters:

lanuguage - The lanuguage (String) parameter.

See Also:

findBestLanguage(String,String[]), getLanguage()

setPath

public void setPath(java.lang.String path)

Parameters:

path - The path (String) parameter.

See Also:

getFilePath(), getPath(), getSimpleFilePath(), setFilePath(String), setSimpleFilePath(String)

setPidMetadata

public void setPidMetadata(java.util.Hashtable pidMetadata)

Parameters:

pidMetadata - The pid metadata (Hashtable) parameter.

See Also:

getPidMetadata()

setRequest

public void setRequest(javax.servlet.http.HttpServletRequest request)

Parameters:

request - The request (HttpServletRequest) parameter.

See Also:

getRequest(), setupRequest(HttpServletRequest)

setResourceLocations

public void setResourceLocations(java.util.Hashtable resourceLocations)

Parameters:

resourceLocations - The resource locations (Hashtable) parameter.

See Also:

getResourceLocations()

setResponse

public void setResponse(javax.servlet.http.HttpServletResponse response)

Parameters:

response - The response (HttpServletResponse) parameter.

See Also:

getResponse(), setupResponse(HttpServletResponse)

setServerAlias

public void setServerAlias(java.lang.String serverAlias)

Parameters:

serverAlias - The server alias (String) parameter.

See Also:

getServerAlias()

setSimpleFilePath

public void setSimpleFilePath(java.lang.String simpleFilePath)

Sets the simple file path value.

Parameters:

simpleFilePath - The simple file path (String) parameter.

See Also:

getSimpleFilePath()

setupEntities

public void setupEntities()

Setup entities.

See Also:

addEntities(Dictionary), addEntities(Map), getEntities(), setEntities(Hashtable)

setupRequest

public void setupRequest(javax.servlet.http.HttpServletRequest request)

Parameters:

request - The request (HttpServletRequest) parameter.

See Also:

getRequest(), setRequest(HttpServletRequest)

setupResponse

public void setupResponse(javax.servlet.http.HttpServletResponse response)

Parameters:

response - The response (HttpServletResponse) parameter.

See Also:

getResponse(), setResponse(HttpServletResponse)

setWriter

public void setWriter(java.io.PrintWriter writer)

Parameters:

writer - The writer (PrintWriter) parameter.

See Also:

getWriter()

sort

public void sort(org.osgi.framework.Bundle[] bundles)

Parameters:

bundles - The bundles (Bundle[]) parameter.

See Also:

sort(String[]), sort(ServiceReference[])

sort

public void sort(org.osgi.framework.ServiceReference[] serviceReferences)

Parameters:

serviceReferences - The service references (ServiceReference[]) parameter.

See Also:

sort(String[]), sort(Bundle[])

sort

public void sort(java.lang.String[] strings)

Parameters:

strings - The strings (String[]) parameter.

See Also:

sort(ServiceReference[]), sort(Bundle[])

template

public void template(java.lang.String name)

Parameters:

name - The name (String) parameter.

templateInputStream

public java.io.InputStream templateInputStream(java.lang.String name)

Parameters:

name - The name (String) parameter.

Returns:

Results of the template input stream (InputStream) value.