NewCookie (Jakarta EE 8 Specification API)

java.lang.ObjectSE
- javax.ws.rs.core.Cookie
- - javax.ws.rs.core.NewCookie

```
public class NewCookie
extends Cookie
```
レスポンスで転送される新しい HTTP Cookie を作成するために使用されます。
導入:
1.0
作成者:
Paul Sandoz, Marc Hadley
関連事項:
IETF RFC 2109

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static int`	`DEFAULT_MAX_AGE` Cookie が現在のアプリケーション / ブラウザーセッションで期限切れになることを指定します。

クラス javax.ws.rs.core.Cookie から継承されたフィールド
DEFAULT_VERSION

コンストラクターの概要

コンストラクター
コンストラクターと説明
`NewCookie(Cookie cookie)` 提供された Cookie の情報をコピーする新しいインスタンスを作成します。
`NewCookie(Cookie cookie, StringSE comment, int maxAge, boolean secure)` 提供された Cookie の情報を補足する新しいインスタンスを作成します。
`NewCookie(Cookie cookie, StringSE comment, int maxAge, DateSE expiry, boolean secure, boolean httpOnly)` 提供された Cookie の情報を補足する新しいインスタンスを作成します。
`NewCookie(StringSE name, StringSE value)` 新しいインスタンスを作成します。
`NewCookie(StringSE name, StringSE value, StringSE path, StringSE domain, int version, StringSE comment, int maxAge, boolean secure)` 新しいインスタンスを作成します。
`NewCookie(StringSE name, StringSE value, StringSE path, StringSE domain, int version, StringSE comment, int maxAge, DateSE expiry, boolean secure, boolean httpOnly)` 新しいインスタンスを作成します。
`NewCookie(StringSE name, StringSE value, StringSE path, StringSE domain, StringSE comment, int maxAge, boolean secure)` 新しいインスタンスを作成します。
`NewCookie(StringSE name, StringSE value, StringSE path, StringSE domain, StringSE comment, int maxAge, boolean secure, boolean httpOnly)` 新しいインスタンスを作成します。

方法の概要

すべてのメソッド静的メソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`boolean`	`equals(ObjectSE obj)` 等しいかどうかを比較します。
`StringSE`	`getComment()` Cookie に関連付けられたコメントを取得します。
`DateSE`	`getExpiry()` Cookie の有効期限を取得します。
`int`	`getMaxAge()` Cookie の最大有効期間を秒単位で取得します。
`int`	`hashCode()` すべてのプロパティをハッシュすることにより、ハッシュコードを生成します。
`boolean`	`isHttpOnly()` この Cookie に `HttpOnly` 属性が含まれている場合、`true` を返します。
`boolean`	`isSecure()` Cookie が安全な接続を介してのみ送信されるかどうか。
`Cookie`	`toCookie()` この `NewCookie` と同じ名前、値、パス、ドメイン、バージョンを持つ `Cookie` の新しいインスタンスを取得します。
`StringSE`	`toString()` Cookie を、対応する HTTP ヘッダーの値として使用するのに適した文字列に変換します。
`static NewCookie`	`valueOf(StringSE value)` 指定された文字列を解析して、NewCookie の新しいインスタンスを作成します。

クラス javax.ws.rs.core.Cookie から継承されたメソッド
getDomain, getName, getPath, getValue, getVersion

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, finalizeSE, getClassSE, notifySE, notifyAllSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - DEFAULT_MAX_AGE
```
public static final int DEFAULT_MAX_AGE
```
    Cookie が現在のアプリケーション / ブラウザーセッションで期限切れになることを指定します。
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - NewCookie
```
public NewCookie(StringSE name,
                 StringSE value)
```
    新しいインスタンスを作成します。
    パラメーター:
    name - クッキーの名前。
    value - クッキーの値。
    例外:
    IllegalArgumentExceptionSE - 名前が null の場合
  - NewCookie
```
public NewCookie(StringSE name,
                 StringSE value,
                 StringSE path,
                 StringSE domain,
                 StringSE comment,
                 int maxAge,
                 boolean secure)
```
    新しいインスタンスを作成します。
    パラメーター:
    name - クッキーの名前。
    value - クッキーの値。
    path - Cookie が有効な URI パス。
    domain - Cookie が有効なホストドメイン。
    comment - コメント。
    maxAge - Cookie の最大経過時間（秒単位）。
    secure - Cookie が安全な接続を介してのみ送信されるかどうかを指定します。
    例外:
    IllegalArgumentExceptionSE - 名前が null の場合
  - NewCookie
```
public NewCookie(StringSE name,
                 StringSE value,
                 StringSE path,
                 StringSE domain,
                 StringSE comment,
                 int maxAge,
                 boolean secure,
                 boolean httpOnly)
```
    新しいインスタンスを作成します。
    パラメーター:
    name - クッキーの名前。
    value - クッキーの値。
    path - Cookie が有効な URI パス。
    domain - Cookie が有効なホストドメイン。
    comment - コメント。
    maxAge - Cookie の最大経過時間（秒単位）。
    secure - Cookie が安全な接続を介してのみ送信されるかどうかを指定します。
    httpOnly - true が Cookie を HTTP のみにする場合、つまり HTTP リクエストの一部としてのみ表示される場合。
    例外:
    IllegalArgumentExceptionSE - 名前が null の場合
    導入:
    2.0
  - NewCookie
```
public NewCookie(StringSE name,
                 StringSE value,
                 StringSE path,
                 StringSE domain,
                 int version,
                 StringSE comment,
                 int maxAge,
                 boolean secure)
```
    新しいインスタンスを作成します。
    パラメーター:
    name - クッキーの名前
    value - クッキーの値
    path - Cookie が有効な URI パス
    domain - Cookie が有効なホストドメイン
    version - Cookie が準拠する仕様のバージョン
    comment - コメント
    maxAge - Cookie の最大有効期間（秒）
    secure - Cookie が安全な接続を介してのみ送信されるかどうかを指定します
    例外:
    IllegalArgumentExceptionSE - 名前が null の場合
  - NewCookie
```
public NewCookie(StringSE name,
                 StringSE value,
                 StringSE path,
                 StringSE domain,
                 int version,
                 StringSE comment,
                 int maxAge,
                 DateSE expiry,
                 boolean secure,
                 boolean httpOnly)
```
    新しいインスタンスを作成します。
    パラメーター:
    name - クッキーの名前
    value - クッキーの値
    path - Cookie が有効な URI パス
    domain - Cookie が有効なホストドメイン
    version - Cookie が準拠する仕様のバージョン
    comment - コメント
    maxAge - Cookie の最大有効期間（秒）
    expiry - Cookie の有効期限。
    secure - Cookie が安全な接続を介してのみ送信されるかどうかを指定します
    httpOnly - true が Cookie を HTTP のみにする場合、つまり HTTP リクエストの一部としてのみ表示される場合。
    例外:
    IllegalArgumentExceptionSE - 名前が null の場合
    導入:
    2.0
  - NewCookie
```
public NewCookie(Cookie cookie)
```
    提供された Cookie の情報をコピーする新しいインスタンスを作成します。
    パラメーター:
    cookie - クローンする Cookie。
    例外:
    IllegalArgumentExceptionSE - Cookie が null の場合
  - NewCookie
```
public NewCookie(Cookie cookie,
                 StringSE comment,
                 int maxAge,
                 boolean secure)
```
    提供された Cookie の情報を補足する新しいインスタンスを作成します。
    パラメーター:
    cookie - クローンする Cookie。
    comment - コメント。
    maxAge - Cookie の最大経過時間（秒単位）。
    secure - Cookie が安全な接続を介してのみ送信されるかどうかを指定します。
    例外:
    IllegalArgumentExceptionSE - Cookie が null の場合
  - NewCookie
```
public NewCookie(Cookie cookie,
                 StringSE comment,
                 int maxAge,
                 DateSE expiry,
                 boolean secure,
                 boolean httpOnly)
```
    提供された Cookie の情報を補足する新しいインスタンスを作成します。
    パラメーター:
    cookie - クローンする Cookie。
    comment - コメント。
    maxAge - Cookie の最大経過時間（秒単位）。
    expiry - Cookie の有効期限。
    secure - Cookie が安全な接続を介してのみ送信されるかどうかを指定します。
    httpOnly - true が Cookie を HTTP のみにする場合、つまり HTTP リクエストの一部としてのみ表示される場合。
    例外:
    IllegalArgumentExceptionSE - Cookie が null の場合
    導入:
    2.0
- メソッドの詳細
  - valueOf
```
public static NewCookie valueOf(StringSE value)
```
    指定された文字列を解析して、NewCookie の新しいインスタンスを作成します。
    パラメーター:
    value - クッキー文字列。
    戻り値:
    新しく作成された NewCookie
    例外:
    IllegalArgumentExceptionSE - 指定された文字列を解析できないか、null である場合
  - getComment
```
public StringSE getComment()
```
    Cookie に関連付けられたコメントを取得します。
    戻り値:
    コメント。設定されていない場合は null
  - getMaxAge
```
public int getMaxAge()
```
    Cookie の最大有効期間を秒で取得します。最大年齢よりも古い Cookie は破棄されます。Cookie は、既存の Cookie を上書きしてすぐに破棄されるため、最大有効期間 0 の新しい Cookie を送信することで設定解除できます。-1 のデフォルト値は、ブラウザー / アプリケーションセッションの終了時に Cookie が破棄されることを示します。
    Max-Age を使用して Cookie の有効期限を制御することをお勧めしますが、一部のブラウザーは Max-Age を理解しないため、getExpiry() Expires} パラメーターの設定が必要になる場合があります。
    戻り値:
    秒単位の最大経過時間。
    関連事項:
    getExpiry()
  - getExpiry
```
public DateSE getExpiry()
```
    クッキーの有効期限を取得します。有効期限が過ぎたクッキーは破棄されます。Cookie の設定を解除するには、過去の有効期限、通常は設定可能な最も低い日付で新しい Cookie を設定します。
    Max-Age を使用して Cookie の有効期限を制御することをお勧めしますが、ブラウザーによっては Max-Age を認識しないため、Expires パラメーターの設定が必要になる場合があります。
    戻り値:
    Cookie の有効期限、または有効期限が設定されていない場合は null。
    導入:
    2.0
    関連事項:
    getMaxAge()
  - isSecure
```
public boolean isSecure()
```
    Cookie が安全な接続でのみ送信されるかどうか。デフォルトは false です。
    戻り値:
    Cookie が安全な接続でのみ送信される場合は true、それ以外の場合は false。
  - isHttpOnly
```
public boolean isHttpOnly()
```
    この Cookie に HttpOnly 属性が含まれている場合は、true を返します。つまり、JavaScript のようなスクリプトエンジンから Cookie にアクセスできないようにする必要があります。
    戻り値:
    この Cookie を http のみと見なす場合は true、それ以外の場合は false。
    導入:
    2.0
  - toCookie
```
public Cookie toCookie()
```
    この NewCookie と同じ名前、値、パス、ドメイン、バージョンの Cookie の新しいインスタンスを取得します。このメソッドを使用して、別の Cookie と等しいかどうかを比較できるオブジェクトを取得できます。Cookie が NewCookie と比較されることは決してないからです。
    戻り値:
    Cookie
  - toString
```
public StringSE toString()
```
    Cookie を、対応する HTTP ヘッダーの値として使用するのに適した文字列に変換します。
    オーバーライド:
    クラス Cookie の toString
    戻り値:
    文字列化された cookie。
  - hashCode
```
public int hashCode()
```
    すべてのプロパティをハッシュすることにより、ハッシュコードを生成します。
    オーバーライド:
    クラス Cookie の hashCode
    戻り値:
    ハッシュコード。
  - equals
```
public boolean equals(ObjectSE obj)
```
    等しいかどうかを比較します。toCookie() を使用して、共通のプロパティのみを考慮して NewCookie を Cookie と比較します。
    オーバーライド:
    クラス Cookie の equals
    パラメーター:
    obj - 比較するオブジェクト
    戻り値:
    オブジェクトがすべてのプロパティに同じ値を持つ NewCookie である場合は true、そうでない場合は false。

クラス NewCookie

フィールドのサマリー

クラス javax.ws.rs.core.Cookie から継承されたフィールド

コンストラクターの概要

方法の概要

クラス javax.ws.rs.core.Cookie から継承されたメソッド

クラス java.lang.ObjectSE から継承されたメソッド

フィールドの詳細

DEFAULT_MAX_AGE

コンストラクターの詳細

NewCookie

NewCookie

NewCookie

NewCookie

NewCookie

NewCookie

NewCookie

NewCookie

メソッドの詳細

valueOf

getComment

getMaxAge

getExpiry

isSecure

isHttpOnly

toCookie

toString

hashCode

equals