Interface DisconnectedContainerServices

  • All Superinterfaces:
    ContainerServices, ContainerServicesContext
    All Known Implementing Classes:
    DisconnectedContainerServicesImpl

    public interface DisconnectedContainerServices
    extends ContainerServices
    This interface represents an intermediary between the ASP.net and Microstrategy Java application. At the start of each ASP page request data and all other necessary data must be copied into the object of this class. After request processing is finished response data must be copied from this object to the response.
    Since:
    MicroStrategy Web 7.3.1 or earlier
    • Method Detail

      • addFormAndQueryString

        void addFormAndQueryString​(java.lang.String name,
                                   java.lang.String value)
        Adds a value to the request parameters collection. There can be several values assosiated with the same name in this collection.
        Parameters:
        name - parameter name.
        value - parameter value.
      • setQueryString

        void setQueryString​(java.lang.String queryString)
        Sets HTTP request query string
        Parameters:
        queryString - request query string
      • setRemoteAddress

        void setRemoteAddress​(java.lang.String remoteAddress)
        Set the remote (IP) address for this request
        Parameters:
        remoteAddress - IP address
      • setSessionID

        void setSessionID​(java.lang.String sessionID)
        Sets the HTTP session ID
        Parameters:
        sessionID - HTTP session ID
      • setMethod

        void setMethod​(java.lang.String method)
        Sets the request method
        Parameters:
        request - type post/get is required
      • getResponseCookiesCount

        int getResponseCookiesCount()
        Returns number of cookeis that must be added to the response
        Returns:
        number of cookeis that must be added to the response
      • getResponseCookie

        GenericCookie getResponseCookie​(int index)
        Returns a cookie that must be added to the response
        Parameters:
        index - an index in the cookies collection
        Returns:
        a cookie that must be added to the response
      • getRequestAttributesCount

        int getRequestAttributesCount()
        Returns a number of request attributes. The request attributes is a read-writy collection. Attributes can be replaced in it during execution. Therefore entire collection shall be copied in and out of disconnected container services.
        Returns:
        number of request attributes.
      • getRequestAttributeName

        java.lang.String getRequestAttributeName​(int index)
        Returns requst attribute name
        Parameters:
        index - an index in the attribute collection
        Returns:
        requst attribute name
      • getRequestAttribute

        java.lang.Object getRequestAttribute​(int index)
        Returns requst attribute
        Parameters:
        index - an index in the attribute collection
        Returns:
        request attribute
      • getSessionAttributesCount

        int getSessionAttributesCount()
        Returns a number of session attributes. The session attributes is a read-writy collection. Attributes can be replaced in it during execution. Therefore entire collection shall be copied in and out of disconnected container services.
        Returns:
        number of session attributes.
      • getSessionAttributeName

        java.lang.String getSessionAttributeName​(int i)
        Returns session attribute name
        Parameters:
        i - an index in the attribute collection
        Returns:
        session attribute name
      • getSessionAttribute

        java.lang.Object getSessionAttribute​(int i)
        Returns session attribute
        Parameters:
        i - an index in the attribute collection
        Returns:
        session attribute
      • setNativeSessionAttribute

        void setNativeSessionAttribute​(java.lang.String nativeName,
                                       java.lang.Object nativeValue)
        This method sets the value of a Session Attribute without using namespace in Session variable.
        Parameters:
        nativeName - A String which identifies the name of the attribute.
        nativeValue - An Object representing the value of a named attribute. If used in namespaced mode, the native value should containes the namespace encoding, that can be loaded by LRUHashList.load(String)
        Since:
        MicroStrategy Web 8.0.2
      • getBinaryMarkup

        MarkupOutput getBinaryMarkup()
        Returns markup outut stored at the sendBinaryContent method. If this method returns not null the content of markup output must be displayed.
        Returns:
        binary markup output
      • addRequestHeader

        void addRequestHeader​(java.lang.String name,
                              java.lang.String value)
        Adds request header to the internal collection
        Parameters:
        name - header name
        value - header value
      • addCookieToRequest

        void addCookieToRequest​(java.lang.String nativeCookieName,
                                java.lang.String nativeCookieValue)
        Adds request cookie to the internal collection This method is used by non-J2EE environment to add cookies to MicroStrategy Web application.
        Parameters:
        nativeCookieName - The native cookie name used in browser
        nativeCookieValue - The native cookie value stored in browser
      • getContentType

        java.lang.String getContentType()
        Returns response content type
        Returns:
        response content type
      • getResponseHeadersCount

        int getResponseHeadersCount()
        Returns number of response headers
        Returns:
        number of response headers
      • getResponseHeaderName

        java.lang.String getResponseHeaderName​(int index)
        Returns response header name
        Parameters:
        index - an index in the collection
        Returns:
        response header name
      • getResponseHeaderValue

        java.lang.String getResponseHeaderValue​(int index)
        Returns response header value
        Parameters:
        index - an index in the collection
        Returns:
        response header value
      • handleMultipartRequest

        void handleMultipartRequest​(byte[] request)
                             throws java.io.IOException
        This method shall be called if the request type is multipart/form-data
        Parameters:
        request - a byte array containing entire HTTP request
        Throws:
        java.io.IOException
      • getGlobalContext

        AppGlobalContext getGlobalContext()
        Returns the global context held by this services.
        Returns:
        an AppGlobalContext. If there has no AppGlobalContext been set to this object, nulll will be returned.
      • setGlobalContext

        void setGlobalContext​(AppGlobalContext globalContext)
        Sets current application global context.
        Parameters:
        globalContext - is an AppGlobalContext object.
      • getApplicationAttributesCount

        int getApplicationAttributesCount()
        Returns a number of application attributes. The Application attributes is a read-writy collection. Attributes can be replaced in it during execution. Therefore entire collection shall be copied in and out of disconnected container services.
        Returns:
        number of Application attributes.
      • getApplicationAttributeName

        java.lang.String getApplicationAttributeName​(int index)
        Returns application attribute name
        Parameters:
        index - an index in the attribute collection
        Returns:
        application attribute name
      • getApplicationAttribute

        java.lang.Object getApplicationAttribute​(int index)
        Returns application attribute
        Parameters:
        index - an index in the attribute collection
        Returns:
        application attribute
      • addServerVariable

        void addServerVariable​(java.lang.String name,
                               java.lang.String value)
        Adds a server variable with a single value. If the server variable already exists, appends the new value
        Parameters:
        name - the name of the server variable.
        value - the value of the server variable.
        Since:
        MicroStrategy Web 7.5.4
      • addServerVariable

        void addServerVariable​(java.lang.String name,
                               java.lang.String[] values)
        Appends a collection of string values of the specified server variable. If the server variable already exists, appends the new values.
        Parameters:
        name - the name of the server variable.
        values - an array of string values of the server variable.
        Since:
        MicroStrategy Web 7.5.4
      • setRequestSecure

        void setRequestSecure​(boolean value)
        Sets a boolean indicating whether this request was made using a secure channel, such as HTTPS
        Since:
        MicroStrategy Web 9.0.0
      • getCreateNewSessionValue

        boolean getCreateNewSessionValue()
        Gets a boolean value indicating whether create a new http session
      • setCreateNewSessionValue

        void setCreateNewSessionValue​(boolean value)
        Sets a boolean indicating whether create a new http session