BBjCookie::setDomain

Description

In BBj 12.0 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

Variable	Description
domain	a String containing the domain name within which this cookie is visible; form is according to RFC 2109

Return Value

None.

Remarks

The example below shows setting the domain in a BBjCookie of a within a BBjServlet

Example

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