BBjCookie::setPath

Description

In BBj 12.00 and higher, this method sets the path for the cookie to which the client should return the BBjCookie.

The cookie is visible to all the pages in the directory you specify, and all the pages in that directory's sub-directories. A cookie's path must include the servlet that set the cookie, for example, /catalog, which makes the cookie visible to all directories on the server under /catalog.

Consult RFC 2109 (available on the Internet) for more information on setting path names for cookies.

Syntax

Return Value	Method
void	setPath(string `uri`)

Parameters

Parameter	Description
uri	A String specifying a path.

Return Value

None.

Example

The example below shows setting the path for a BBjCookie of a within a BBjServlet.

rem 'Obtain the instance of the BBjAPI object

let myAPI! = BBjAPI()
MyServlet! = new MyServlet()

data!.setCallback(data!.ON_WEB_CONNECTION, myServlet!, "myMethod")

process_events
class public MyServlet
    method public void myMethod(BBjServletEvent p_event!)
        let chan = UNT
        request! = p_event!.getHttpRequest()
        response! = p_event!.getHttpResponse()
        response!.setContentType("text/html")
        cookie! = response!.addCookie("MyCookie")
        cookie!.setValue("My cookie data")
        cookie!.setPath("/servlet/MyServlet")
        cookie!.setDomain("www.wibble.com")
        cookie!.setMaxAge(3600)
        cookie!.setSecure(0)
        cookie!.setVersion(1)
        cookie!.setComment("comment)
        open (chan)"JSERVLET"
        print (chan)"<html><body><h1>Hello BBj!</h1>"
        print (chan)"</body></html>"
        close (chan)
    methodend
classend

See Also

BBxServletContext

BBxServletResponse

BBxServletRequest