Package io.guise.framework.platform.web
Interface WebPlatform
- All Superinterfaces:
Platform
- All Known Implementing Classes:
AbstractWebPlatform
,HTTPServletWebPlatform
The web platform for Guise.
- Author:
- Garret Wilson
-
Nested Class Summary
Modifier and TypeInterfaceDescriptionstatic enum
The types of JavaScript-based HTML editors available.static enum
The web commands for controlling polling. -
Field Summary
Modifier and TypeFieldDescriptionstatic final com.globalmentor.net.URIPath
The path of the AJAX JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the compressed AJAX JavaScript file, relative to the application.static final String
The Guise attribute containing the hash of the element attributes.static final String
The HTML class attribute indicating content.static final String
The Guise attribute containing the hash of the element content.static final String
The Guise attribute indicating the content type of an element's contents.static final String
The Guise attribute indicating the type of patching that should occur.static final String
The Guise attribute value indicating that no patching should occur on the value.static final String
The Guise attribute value indicating that no patching should occur.static final String
The Guise attribute value indicating that the element is a temporary element that will be replaced later; functions just like "none" for patching except that this element will be removed from the original hierarchy.static final com.globalmentor.net.URIPath
The path of the blank MP3 file, relative to the application.static final com.globalmentor.net.URIPath
The path of the CKEditor JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the compressed CKEditor JavaScript file, relative to the application.static final String
The version of CKEditor in use.static final com.globalmentor.net.URIPath
The path of the DOM JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the compressed DOM JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the domready JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the compressed domready JavaScript file, relative to the application.static final String
The Guise image attribute indicating the original source location of the image.static final String
The Guise image attribute indicating the source location of the image to be used for rollovers.static final String
The Guise textarea attribute indicating whether the user should be allowed to enter multiple physical lines; value is "true" or "false".static final com.globalmentor.net.URIPath
The path of the Google Gears JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the compressed Google Gears JavaScript file, relative to the application.static final com.globalmentor.net.MediaType
The media type of a Guise AJAX request,application/x-guise-ajax-request
.static final com.globalmentor.net.MediaType
The media type of a Guise AJAX response,application/x-guise-ajax-response
.static final com.globalmentor.net.URIPath
The path of the empty HTML document, relative to the application.static final com.globalmentor.net.URIPath
The path of the Guise Flash file, relative to the application.static final com.globalmentor.net.URIPath
The path of the Guise JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the compressed Guise JavaScript file, relative to the application.static final String
The standard prefix to use with the Guise markup language namespace.static final URI
The namespace of the Guise markup language to be used with XHTML.static final String
The URI query parameter used to specify a Guise session by UUID, overriding the Guise session based upon the HTTP session identified by the request.static final String
The URI query parameter used to indicate the Guise version to prevent caching between versions.static final String
The public ID of the Guise XHTML DTD.static final WebPlatform.HTMLEditor
The editor used by the platform.static final com.globalmentor.net.URIPath
The path of the JavaScript JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the compressed JavaScript JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the TinyMCE JavaScript file, relative to the application.static final com.globalmentor.net.URIPath
The path of the compressed TinyMCE JavaScript file, relative to the application. -
Method Summary
Modifier and TypeMethodDescriptionboolean
discontinuePollInterval
(DepictedObject depictedObject) Indicates that a depicted object no longer requests a particular polling interval.Retrieves information and functionality related to the current depiction.long
getDepictID
(String depictIDString) Returns the depicted object ID represented by the given platform-specific ID string.getDepictIDString
(long depictID) Generates an ID for the given depicted object appropriate for using on the platform.int
boolean
requestPollInterval
(DepictedObject depictedObject, int pollInterval) Requests a polling interval for a given depicted object.void
setPollInterval
(int newPollInterval) Sets the polling interval in milliseconds.Methods inherited from interface io.guise.framework.platform.Platform
generateDepictID, getApplication, getDepictedObject, getDepictLock, getDepictor, getEnvironment, registerDepictedObject, selectPlatformFiles, sendResource, sendResource, sendResource, sendResource, unregisterDepictedObject
-
Field Details
-
CKEDITOR_VERSION
The version of CKEditor in use.- See Also:
-
GUISE_ML_NAMESPACE_URI
The namespace of the Guise markup language to be used with XHTML. -
GUISE_ML_NAMESPACE_PREFIX
The standard prefix to use with the Guise markup language namespace.- See Also:
-
GUISE_XHTML_DTD_PUBLIC_ID
The public ID of the Guise XHTML DTD.- See Also:
-
GUISE_SESSION_UUID_URI_QUERY_PARAMETER
The URI query parameter used to specify a Guise session by UUID, overriding the Guise session based upon the HTTP session identified by the request.- See Also:
-
GUISE_VERSION_URI_QUERY_PARAMETER
The URI query parameter used to indicate the Guise version to prevent caching between versions.- See Also:
-
GUISE_AJAX_REQUEST_MEDIA_TYPE
static final com.globalmentor.net.MediaType GUISE_AJAX_REQUEST_MEDIA_TYPEThe media type of a Guise AJAX request,application/x-guise-ajax-request
. -
GUISE_AJAX_RESPONSE_MEDIA_TYPE
static final com.globalmentor.net.MediaType GUISE_AJAX_RESPONSE_MEDIA_TYPEThe media type of a Guise AJAX response,application/x-guise-ajax-response
. -
HTML_EDITOR
The editor used by the platform. -
ELEMENT_IMG_ATTRIBUTE_ORIGINAL_SRC
The Guise image attribute indicating the original source location of the image.- See Also:
-
ELEMENT_IMG_ATTRIBUTE_ROLLOVER_SRC
The Guise image attribute indicating the source location of the image to be used for rollovers.- See Also:
-
ELEMENT_TEXTAREA_ATTRIBUTE_MULTILINE
The Guise textarea attribute indicating whether the user should be allowed to enter multiple physical lines; value is "true" or "false".- See Also:
-
ATTRIBUTE_ATTRIBUTE_HASH
The Guise attribute containing the hash of the element attributes.- See Also:
-
ATTRIBUTE_CONTENT_HASH
The Guise attribute containing the hash of the element content.- See Also:
-
ATTRIBUTE_CONTENT_TYPE
The Guise attribute indicating the content type of an element's contents.- See Also:
-
ATTRIBUTE_PATCH_TYPE
The Guise attribute indicating the type of patching that should occur.- See Also:
-
ATTRIBUTE_PATCH_TYPE_NO_VALUE
The Guise attribute value indicating that no patching should occur on the value.- See Also:
-
ATTRIBUTE_PATCH_TYPE_NONE
The Guise attribute value indicating that no patching should occur.- See Also:
-
ATTRIBUTE_PATCH_TYPE_TEMP
The Guise attribute value indicating that the element is a temporary element that will be replaced later; functions just like "none" for patching except that this element will be removed from the original hierarchy.- See Also:
-
ATTRIBUTE_CLASS_CONTENT
The HTML class attribute indicating content.- See Also:
-
BLANK_MP3_PATH
static final com.globalmentor.net.URIPath BLANK_MP3_PATHThe path of the blank MP3 file, relative to the application. -
GUISE_EMPTY_HTML_DOCUMENT_PATH
static final com.globalmentor.net.URIPath GUISE_EMPTY_HTML_DOCUMENT_PATHThe path of the empty HTML document, relative to the application. -
AJAX_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath AJAX_JAVASCRIPT_PATHThe path of the AJAX JavaScript file, relative to the application. -
AJAX_MIN_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath AJAX_MIN_JAVASCRIPT_PATHThe path of the compressed AJAX JavaScript file, relative to the application. -
DOM_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath DOM_JAVASCRIPT_PATHThe path of the DOM JavaScript file, relative to the application. -
DOM_MIN_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath DOM_MIN_JAVASCRIPT_PATHThe path of the compressed DOM JavaScript file, relative to the application. -
DOMREADY_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath DOMREADY_JAVASCRIPT_PATHThe path of the domready JavaScript file, relative to the application. -
DOMREADY_MIN_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath DOMREADY_MIN_JAVASCRIPT_PATHThe path of the compressed domready JavaScript file, relative to the application. -
GOOGLE_GEARS_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath GOOGLE_GEARS_JAVASCRIPT_PATHThe path of the Google Gears JavaScript file, relative to the application. -
GOOGLE_GEARS_MIN_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath GOOGLE_GEARS_MIN_JAVASCRIPT_PATHThe path of the compressed Google Gears JavaScript file, relative to the application. -
GUISE_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath GUISE_JAVASCRIPT_PATHThe path of the Guise JavaScript file, relative to the application. -
GUISE_MIN_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath GUISE_MIN_JAVASCRIPT_PATHThe path of the compressed Guise JavaScript file, relative to the application. -
JAVASCRIPT_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath JAVASCRIPT_JAVASCRIPT_PATHThe path of the JavaScript JavaScript file, relative to the application. -
JAVASCRIPT_MIN_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath JAVASCRIPT_MIN_JAVASCRIPT_PATHThe path of the compressed JavaScript JavaScript file, relative to the application. -
CKEDITOR_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath CKEDITOR_JAVASCRIPT_PATHThe path of the CKEditor JavaScript file, relative to the application. -
CKEDITOR_MIN_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath CKEDITOR_MIN_JAVASCRIPT_PATHThe path of the compressed CKEditor JavaScript file, relative to the application. -
TINYMCE_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath TINYMCE_JAVASCRIPT_PATHThe path of the TinyMCE JavaScript file, relative to the application. -
TINYMCE_MIN_JAVASCRIPT_PATH
static final com.globalmentor.net.URIPath TINYMCE_MIN_JAVASCRIPT_PATHThe path of the compressed TinyMCE JavaScript file, relative to the application. -
GUISE_FLASH_PATH
static final com.globalmentor.net.URIPath GUISE_FLASH_PATHThe path of the Guise Flash file, relative to the application.
-
-
Method Details
-
getDepictIDString
Generates an ID for the given depicted object appropriate for using on the platform.- Parameters:
depictID
- The depict ID to be converted to a platform ID.- Returns:
- The form of the depict ID appropriate for using on the platform.
-
getDepictID
Returns the depicted object ID represented by the given platform-specific ID string.- Parameters:
depictIDString
- The platform-specific form of the depict ID.- Returns:
- The depict ID the platform-specific form represents.
- Throws:
NullPointerException
- if the given string isnull
.IllegalArgumentException
- if the given string does not represent the correct string form of a depict ID on this platform.
-
getClientProduct
WebUserAgentProduct getClientProduct()- Specified by:
getClientProduct
in interfacePlatform
- Returns:
- The user agent client, such as a browser, used to access Guise on this platform.
-
getDepictContext
WebDepictContext getDepictContext()Retrieves information and functionality related to the current depiction.- Specified by:
getDepictContext
in interfacePlatform
- Returns:
- A context for the current depiction.
- Throws:
IllegalStateException
- if no depict context can be returned in the current depiction state.
-
getSendMessageQueue
Queue<WebPlatformMessage> getSendMessageQueue()- Specified by:
getSendMessageQueue
in interfacePlatform
- Returns:
- The thread-safe queue of messages to be delivered to the platform.
-
getPollInterval
int getPollInterval()- Returns:
- The current polling interval in milliseconds.
-
setPollInterval
void setPollInterval(int newPollInterval) Sets the polling interval in milliseconds.- Parameters:
newPollInterval
- The polling interval in milliseconds.- Throws:
IllegalArgumentException
- if the given polling interval is less than zero.
-
requestPollInterval
Requests a polling interval for a given depicted object. The actual polling interval will be updated if the given polling interval is smaller than the current actual polling interval.- Parameters:
depictedObject
- The depicted object requesting a polling interval.pollInterval
- The polling interval in milliseconds.- Returns:
true
if the polling interval changed as a result of this request.- Throws:
NullPointerException
- if the given depicted object isnull
.IllegalArgumentException
- if the value is less than zero.- See Also:
-
discontinuePollInterval
Indicates that a depicted object no longer requests a particular polling interval. The actual polling interval will be updated if the relinquished poll interval is less than or equal to the current poll interval.- Parameters:
depictedObject
- The depicted object that is relinquishing a polling interval.- Returns:
true
if the polling interval changed as a result of this relinquishment.- Throws:
NullPointerException
- if the given depicted object isnull
.- See Also:
-