BBjHttpResponse::setLocale

Description

In BBj 12.0 and higher, this method sets the locale of the response. It also sets the response's character encoding appropriately for the locale, if the character encoding has not been explicitly set using BBjHttpResponse::setContentType(String) or BBjHttpResponse::setCharacterEncoding(String).

This method may be called repeatedly to change locale and character encoding. It does not set the response's character encoding if it is called after BBjHttpResponse::setContentType(String) has been called with a charset specification or after BBjHttpResponse::setCharacterEncoding(String) has been called.

Syntax

Return Value	Method
void	setLocale(Locale locale)

Parameters

Variable	Description
locale	the locale of the response

Return Value

None.

Remarks

The example below shows setting a Locale 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")
    response.setLocale(new java.lang.Locale("fr", "CA"))
    open (chan)"JSERVLET"
    print (chan)"<html><body><h1>Hello BBj!</h1>"
    print (chan)"Locale:" + str(response!.getLocale())
    print (chan)"</body></html>"
    close (chan)
  methodend
classend