BBjCookie::setDomain

Description

In BBj 12.00 and higher, this method sets the domain within which this cookie should be presented.

The form of the domain name is specified by RFC 2109. A domain name begins with a dot (.foo.com) and means that the cookie is visible to servers in a specified Domain Name System (DNS) zone (for example, www.foo.com, but not a.b.foo.com). By default, cookies are only returned to the server that sent them.

Syntax

Return Value	Method
void	setDomain(string `domain`)

Parameters

Parameter	Description
domain	A String containing the domain name within which this cookie is visible; form is according to RFC 2109.

Return Value

None.

Example

The example below shows setting the domain in 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