ERXBrowser (Project Wonder Reference Documentation)

java.lang.Object
- er.extensions.appserver.ERXBrowser

All Implemented Interfaces:

com.webobjects.foundation.NSKeyValueCoding

Direct Known Subclasses:

ERXBasicBrowser
```
public abstract class ERXBrowser
extends Object
implements com.webobjects.foundation.NSKeyValueCoding
```
ERXBrowser is an abstract class that defines browser object. A browser object represents the web browser that the current request-response loop is dealing with. It holds the information retrieved from HTTP request's "user-agent" header, and such information includes web browser's name, version, Mozilla compatible version and platform (OS). Also, a browser object can answer boolean questions such as isIE, isOmniWeb, isVersion5 and isMozilla40Compatible.
ERXBrowser is immutable and shared by different sessions and direct actions. The shared instances are managed by ERXBrowserFactory which is also responsible to parse "user-agent" header in a WORequest object and to get an appropriate browser object.
One concrete browser, ERXBasicBrowser, is defined in the ERExtensions framework. It not only implements the basic questions defined by ERXBrowser, but also more specific questions like isIFrameSupported and willRenderNestedTablesFast.
You can extend ERXBrowser or its concrete subclass ERXBasicBrowser to implement more specific questions for your application. One good example will be to have a question isSupportedBrowser that checks if the client is using one of the supported browsers for your application.
ERXSession holds a browser object that represent the web browser for that session and browser method returns the object. To access ERXBrowser's boolean questions from WOConditionals on a web component, set the key path like "session.brower.isIFrameSupported" to their condition bindings.
ERXDirectAction also holds a browser object for the current request. Use its browser method to access the object from a session-less direct action.

ERXBrowser はブラウザ・オブジェクトを表現する抽象的なクラスです。ブラウザ・オブジェクトはカレント・リクエスト・レスポンス・ループの Webブラウザを表現しています。 HTTPリクエスト "user-agent" より情報を取得し、 Webブラウザ名、バージョン番号、プラットフォームと Mozilla バージョン番号等々を含みます。他には boolean で isIE, isOmniWeb, isVersion5 と isMozilla40Compatibleの情報を簡単にアクセスできます。
ERXBrowser は不変で、他のセッションとダイレクト・アクションで共有されています。共有インスタンスは ERXBrowserFactory で管理されています。他には ERXBrowserFactory が WORequest の "user-agent" パースとブラウザ・オブジェクトの作成を担当しています。
ERExtensions フレームワークには ERXBasicBrowser ブラウザ・オブジェクトが明確にされている。 ERXBrowser の基本な調査メソッドのみではなく、もっと確実な isIFrameSupported と willRenderNestedTablesFast を回答します。
自分のアプリケーションの為に ERXBrowser や ERXBasicBrowser のサブクラスをつくることができます。例：アプリケーションでサポートされているブラウザかどうかの isSupportedBrowser を追加できます。
ERXSession はブラウザ・オブジェクトを保持し、セッションにアクセスしている Web Browser の情報を持っている。 browser メソッドでオブジェクトを取得できます。
コンポーネント内の WOConditionals より ERXBrowser の boolean を問い合わせにアクセスする時、次のようなキーパス "session.brower.isIFrameSupported" をバインディングします。
ERXDirectAction もカレント・リクエストのブラウザ・オブジェクトを保持します。オブジェクトをアクセスするには browser メソッドを使用します。

Nested Class Summary
- Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding
  com.webobjects.foundation.NSKeyValueCoding._BooleanFieldBinding, com.webobjects.foundation.NSKeyValueCoding._BooleanMethodBinding, com.webobjects.foundation.NSKeyValueCoding._FieldBinding, com.webobjects.foundation.NSKeyValueCoding._ForwardingBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding._MethodBinding, com.webobjects.foundation.NSKeyValueCoding._NumberFieldBinding, com.webobjects.foundation.NSKeyValueCoding._NumberMethodBinding, com.webobjects.foundation.NSKeyValueCoding._ReflectionKeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding.DefaultImplementation, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, com.webobjects.foundation.NSKeyValueCoding.MapImplementation, com.webobjects.foundation.NSKeyValueCoding.Null<T>, com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException, com.webobjects.foundation.NSKeyValueCoding.Utility, com.webobjects.foundation.NSKeyValueCoding.ValueAccessor

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ANDROID`
`static String`	`CHROME`
`static String`	`EDGE`
`static String`	`FIREFOX`
`static String`	`ICAB`
`static String`	`IE`
`static String`	`IPAD`
`static String`	`IPHONE`
`static String`	`LINUX`
`static String`	`MACOS`
`static String`	`MOZILLA`
`static String`	`NETSCAPE`
`static String`	`NO_GECKO`
`static String`	`OMNIWEB`
`static String`	`OPERA`
`static String`	`POWER_PC`
`static String`	`ROBOT`
`static String`	`SAFARI`
`static String`	`UNKNOWN_BROWSER`
`static String`	`UNKNOWN_CPU`
`static String`	`UNKNOWN_PLATFORM`
`static String`	`UNKNOWN_VERSION`
`static String`	`WINDOWS`

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding
_CLASS, NullValue

Constructor Summary

Constructors
Constructor and Description

ERXBrowser()

Constructors
Constructor and Description
`ERXBrowser()`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`abstract String`	`browserName()` Browser name string ブラウザ名を戻します
`String`	`formValueEncoding()` If using ERXRequest objects allows one to override on a per browser basis what form value encoding to use.
`abstract String`	`geckoRevision()` The revision of the gecko rendering engine.
`abstract boolean`	`isAndroid()`
`abstract boolean`	`isChrome()` Browser is Chrome? ブラウザは Chrome ですか？
`abstract boolean`	`isEdge()` Browser is Microsoft Edge? ブラウザは Microsoft Edge ですか？
`abstract boolean`	`isFirefox()` Browser is Firefox? ブラウザは Firefox ですか？
`abstract boolean`	`isICab()` Browser is iCab? ブラウザは iCab ですか？
`abstract boolean`	`isIE()` Browser is Internet Explorer? ブラウザは Internet Explorer ですか？
`abstract boolean`	`isIPad()`
`abstract boolean`	`isIPhone()`
`abstract boolean`	`isLinux()`
`abstract boolean`	`isMacOS()`
`abstract boolean`	`isMozilla40Compatible()`
`abstract boolean`	`isMozilla45Compatible()`
`abstract boolean`	`isMozilla50Compatible()`
`abstract boolean`	`isNetscape()` Browser is Netscape? ブラウザは Netscape ですか？
`abstract boolean`	`isNotNetscape()` Browser is not Netscape? ブラウザは Netscape ではないか？
`abstract boolean`	`isOmniWeb()` Browser is OmniWeb? ブラウザは OmniWeb ですか？
`abstract boolean`	`isOpera()` Browser is Opera? ブラウザは Opera ですか？
`abstract boolean`	`isRobot()` Browser is isRobot? ブラウザはロボットですか？
`abstract boolean`	`isSafari()` Browser is Safari? ブラウザは Safari ですか？
`abstract boolean`	`isUnknownBrowser()` 未知のブラウザ？
`abstract boolean`	`isUnknownPlatform()`
`abstract boolean`	`isVersion2()`
`abstract boolean`	`isVersion3()`
`abstract boolean`	`isVersion4()`
`abstract boolean`	`isVersion40()`
`abstract boolean`	`isVersion41()`
`abstract boolean`	`isVersion45()`
`abstract boolean`	`isVersion5()`
`abstract boolean`	`isVersion51()`
`abstract boolean`	`isVersion6()`
`abstract boolean`	`isVersion7()`
`abstract boolean`	`isVersion8()`
`abstract boolean`	`isVersion9()`
`abstract boolean`	`isWindows()`
`abstract Integer`	`majorVersion()` Major version
`ERXMessageEncoding`	`messageEncodingForLanguage(String language)` Gets the message encoding for a given language.
`ERXMessageEncoding`	`messageEncodingForLanguages(NSArray languages)` Gets the message encoding for a given array of languages.
`ERXMessageEncoding`	`messageEncodingForRequest(com.webobjects.appserver.WORequest request)` Gets the message encoding for a given request.
`abstract String`	`mozillaVersion()` MozillaVersion string ブラウザの Mozilla バージョンを戻します
`abstract String`	`platform()` Platform string プラットフォームを戻します
`void`	`takeValueForKey(Object value, String key)`
`String`	`toString()`
`abstract NSDictionary`	`userInfo()` UserInfo dictionary UserInfo ディクショナリーを戻します
`Object`	`valueForKey(String key)`
`abstract String`	`version()` Version string ブラウザのバージョンアップを戻します

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - UNKNOWN_BROWSER
```
public static final String UNKNOWN_BROWSER
```
    See Also:
    
    Constant Field Values
  - ROBOT
```
public static final String ROBOT
```
    See Also:
    
    Constant Field Values
  - ICAB
```
public static final String ICAB
```
    See Also:
    
    Constant Field Values
  - EDGE
```
public static final String EDGE
```
    See Also:
    
    Constant Field Values
  - IE
```
public static final String IE
```
    See Also:
    
    Constant Field Values
  - NETSCAPE
```
public static final String NETSCAPE
```
    See Also:
    
    Constant Field Values
  - OMNIWEB
```
public static final String OMNIWEB
```
    See Also:
    
    Constant Field Values
  - OPERA
```
public static final String OPERA
```
    See Also:
    
    Constant Field Values
  - SAFARI
```
public static final String SAFARI
```
    See Also:
    
    Constant Field Values
  - MOZILLA
```
public static final String MOZILLA
```
    See Also:
    
    Constant Field Values
  - CHROME
```
public static final String CHROME
```
    See Also:
    
    Constant Field Values
  - FIREFOX
```
public static final String FIREFOX
```
    See Also:
    
    Constant Field Values
  - UNKNOWN_VERSION
```
public static final String UNKNOWN_VERSION
```
    See Also:
    
    Constant Field Values
  - UNKNOWN_PLATFORM
```
public static final String UNKNOWN_PLATFORM
```
    See Also:
    
    Constant Field Values
  - MACOS
```
public static final String MACOS
```
    See Also:
    
    Constant Field Values
  - WINDOWS
```
public static final String WINDOWS
```
    See Also:
    
    Constant Field Values
  - LINUX
```
public static final String LINUX
```
    See Also:
    
    Constant Field Values
  - ANDROID
```
public static final String ANDROID
```
    See Also:
    
    Constant Field Values
  - IPHONE
```
public static final String IPHONE
```
    See Also:
    
    Constant Field Values
  - IPAD
```
public static final String IPAD
```
    See Also:
    
    Constant Field Values
  - POWER_PC
```
public static final String POWER_PC
```
    See Also:
    
    Constant Field Values
  - UNKNOWN_CPU
```
public static final String UNKNOWN_CPU
```
    See Also:
    
    Constant Field Values
  - NO_GECKO
```
public static final String NO_GECKO
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - ERXBrowser
```
public ERXBrowser()
```
- Method Detail
  - browserName
```
public abstract String browserName()
```
    Browser name string
    
    ブラウザ名を戻します
    
    Returns:
    
    what type of browser
    
    ブラウザ名
  - version
```
public abstract String version()
```
    Version string
    
    ブラウザのバージョンアップを戻します
    
    Returns:
    
    what version of browser
    
    ブラウザのバージョンアップ
  - majorVersion
```
public abstract Integer majorVersion()
```
    Major version
    
    Returns:
    
    what major version of browser
  - mozillaVersion
```
public abstract String mozillaVersion()
```
    MozillaVersion string
    
    ブラウザの Mozilla バージョンを戻します
    
    Returns:
    
    Mozilla version equivalent to the browser's version
    
    ブラウザの Mozilla バージョン
  - geckoRevision
```
public abstract String geckoRevision()
```
    The revision of the gecko rendering engine. 1.0.2 and up support xslt.
    
    gecko レンダリング・エンジンのバージョンを戻します
    
    Returns:
    
    gecko revision equivalent to the browser's version
    
    gecko レンダリング・エンジンのバージョンを戻します
  - platform
```
public abstract String platform()
```
    Platform string
    
    プラットフォームを戻します
    
    Returns:
    
    what platform that the browser is running on
    
    プラットフォーム
  - userInfo
```
public abstract NSDictionary userInfo()
```
    UserInfo dictionary
    
    UserInfo ディクショナリーを戻します
    
    Returns:
    
    the user info
    
    UserInfo ディクショナリー
  - isUnknownBrowser
```
public abstract boolean isUnknownBrowser()
```
    未知のブラウザ？
    
    Returns:
    
    true if browser type is unknown
    
    未知のブラウザの場合は true が戻ります
  - isRobot
```
public abstract boolean isRobot()
```
    Browser is isRobot?
    
    ブラウザはロボットですか？
    
    Returns:
    
    true if browser is robot.
    
    ロボットの場合には true が戻ります
  - isICab
```
public abstract boolean isICab()
```
    Browser is iCab?
    
    ブラウザは iCab ですか？
    
    Returns:
    
    true if browser is iCab.
    
    iCab の場合には true が戻ります
  - isEdge
```
public abstract boolean isEdge()
```
    Browser is Microsoft Edge?
    
    ブラウザは Microsoft Edge ですか？
    
    Returns:
    
    true if browser is Edge.
    
    Edge の場合には true が戻ります
  - isIE
```
public abstract boolean isIE()
```
    Browser is Internet Explorer?
    
    ブラウザは Internet Explorer ですか？
    
    Returns:
    
    true if browser is IE.
    
    IE の場合には true が戻ります
  - isNetscape
```
public abstract boolean isNetscape()
```
    Browser is Netscape?
    
    ブラウザは Netscape ですか？
    
    Returns:
    
    true if browser is Netscape.
    
    Netscape の場合には true が戻ります
  - isNotNetscape
```
public abstract boolean isNotNetscape()
```
    Browser is not Netscape?
    
    ブラウザは Netscape ではないか？
    
    Returns:
    
    true if browser is not Netscape.
    
    Netscape でない場合には true が戻ります
  - isOmniWeb
```
public abstract boolean isOmniWeb()
```
    Browser is OmniWeb?
    
    ブラウザは OmniWeb ですか？
    
    Returns:
    
    true if browser is OmniWeb.
    
    OmniWeb の場合には true が戻ります
  - isOpera
```
public abstract boolean isOpera()
```
    Browser is Opera?
    
    ブラウザは Opera ですか？
    
    Returns:
    
    true if browser is Opera.
    
    Opera の場合には true が戻ります
  - isSafari
```
public abstract boolean isSafari()
```
    Browser is Safari?
    
    ブラウザは Safari ですか？
    
    Returns:
    
    true if browser is Safari.
    
    Safari の場合には true が戻ります
  - isFirefox
```
public abstract boolean isFirefox()
```
    Browser is Firefox?
    
    ブラウザは Firefox ですか？
    
    Returns:
    
    true if browser is Firefox.
    
    Firefox の場合には true が戻ります
  - isChrome
```
public abstract boolean isChrome()
```
    Browser is Chrome?
    
    ブラウザは Chrome ですか？
    
    Returns:
    
    true if browser is Chrome.
    
    Chrome の場合には true が戻ります
  - isMozilla50Compatible
```
public abstract boolean isMozilla50Compatible()
```
  - isMozilla45Compatible
```
public abstract boolean isMozilla45Compatible()
```
  - isMozilla40Compatible
```
public abstract boolean isMozilla40Compatible()
```
  - isVersion9
```
public abstract boolean isVersion9()
```
  - isVersion8
```
public abstract boolean isVersion8()
```
  - isVersion7
```
public abstract boolean isVersion7()
```
  - isVersion6
```
public abstract boolean isVersion6()
```
  - isVersion5
```
public abstract boolean isVersion5()
```
  - isVersion51
```
public abstract boolean isVersion51()
```
  - isVersion45
```
public abstract boolean isVersion45()
```
  - isVersion41
```
public abstract boolean isVersion41()
```
  - isVersion40
```
public abstract boolean isVersion40()
```
  - isVersion4
```
public abstract boolean isVersion4()
```
  - isVersion3
```
public abstract boolean isVersion3()
```
  - isVersion2
```
public abstract boolean isVersion2()
```
  - isUnknownPlatform
```
public abstract boolean isUnknownPlatform()
```
  - isMacOS
```
public abstract boolean isMacOS()
```
  - isWindows
```
public abstract boolean isWindows()
```
  - isLinux
```
public abstract boolean isLinux()
```
  - isAndroid
```
public abstract boolean isAndroid()
```
  - isIPhone
```
public abstract boolean isIPhone()
```
  - isIPad
```
public abstract boolean isIPad()
```
  - messageEncodingForRequest
```
public ERXMessageEncoding messageEncodingForRequest(com.webobjects.appserver.WORequest request)
```
    Gets the message encoding for a given request. Default implementation gets the message encoding for all of the browserLanguages off of the request.
    
    指定のリクエストのメッセージ・エンコーディング方法を戻します。デフォルト実装ではリクエストの全てのブラウザ言語のエンコーディング方法を取得します。
    
    Parameters:
    
    request -
    to get the message encoding for
    
    リクエスト WORequest
    
    Returns:
    
    message encoding
    
    メッセージ・エンコーディング方法
  - messageEncodingForLanguages
```
public ERXMessageEncoding messageEncodingForLanguages(NSArray languages)
```
    Gets the message encoding for a given array of languages.
    
    指定の言語配列のメッセージ・エンコーディング方法を戻します。
    
    Parameters:
    
    languages -
    array to get the correct encoding for
    
    メッセージ・エンコーディング方法を取得したい言語配列
    
    Returns:
    
    message encoding
    
    メッセージ・エンコーディング方法
  - messageEncodingForLanguage
```
public ERXMessageEncoding messageEncodingForLanguage(String language)
```
    Gets the message encoding for a given language.
    
    指定の言語のメッセージ・エンコーディング方法を戻します。
    
    Parameters:
    
    language -
    to get the encoding for
    
    メッセージ・エンコーディング方法を取得したい言語
    
    Returns:
    
    message encoding
    
    メッセージ・エンコーディング方法
  - formValueEncoding
```
public String formValueEncoding()
```
    If using ERXRequest objects allows one to override on a per browser basis what form value encoding to use. Default implementation defaults to null Note that you will need to enable the property: er.extensions.ERXRequest.BrowserFormValueEncodingOverrideEnabled=true in order for the actual over ride to happen.
    
    ERXRequest オブジェクトを使用すると、各ブラウザのエンコーディング方法をオーバライドすることができます。デフォルト実装では null を戻します。オーバライドを使用する為には、次のプロパティーをセットする必要があります。 er.extensions.ERXRequest.BrowserFormValueEncodingOverrideEnabled=true
    
    Returns:
    
    form value encoding to use for this particular user-agent.
    
    指定 user-agent のフォーム・バリューのエンコーディング方法
  - valueForKey
```
public Object valueForKey(String key)
```
    Specified by:
    
    valueForKey in interface com.webobjects.foundation.NSKeyValueCoding
  - takeValueForKey
```
public void takeValueForKey(Object value,
                            String key)
```
    Specified by:
    
    takeValueForKey in interface com.webobjects.foundation.NSKeyValueCoding
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class ERXBrowser

Nested Class Summary

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding

Field Summary

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

UNKNOWN_BROWSER

ROBOT

ICAB

EDGE

IE

NETSCAPE

OMNIWEB

OPERA

SAFARI

MOZILLA

CHROME

FIREFOX

UNKNOWN_VERSION

UNKNOWN_PLATFORM

MACOS

WINDOWS

LINUX

ANDROID

IPHONE

IPAD

POWER_PC

UNKNOWN_CPU

NO_GECKO

Constructor Detail

ERXBrowser

Method Detail

browserName

version

majorVersion

mozillaVersion

geckoRevision

platform

userInfo

isUnknownBrowser

isRobot

isICab

isEdge

isIE

isNetscape

isNotNetscape

isOmniWeb

isOpera

isSafari

isFirefox

isChrome

isMozilla50Compatible

isMozilla45Compatible

isMozilla40Compatible

isVersion9

isVersion8

isVersion7

isVersion6

isVersion5

isVersion51

isVersion45

isVersion41

isVersion40

isVersion4

isVersion3

isVersion2

isUnknownPlatform

isMacOS

isWindows

isLinux

isAndroid

isIPhone

isIPad

messageEncodingForRequest

messageEncodingForLanguages

messageEncodingForLanguage

formValueEncoding