Mac (Java Platform SE 8)

java.lang.Object
- javax.crypto.Mac

すべての実装されたインタフェース:

Cloneable
```
public class Mac
extends Object
implements Cloneable
```
このクラスは、「メッセージ認証コード」(MAC)アルゴリズムの機能を提供します。
MACは、信頼できない媒体に送信または格納された情報の整合性を、秘密キーに基づいてチェックする方法を提供します。一般に、メッセージ認証コードは、秘密キーを共有する2つのパーティ間で送信される情報の有効性を検証する場合に使用されます。
暗号化ハッシュ機能に基づくMACメカニズムは、HMACと呼ばれます。 HMACは、秘密共有キーと組み合せて、SHA256やSHA384などの任意の暗号化ハッシュ機能で使用できます。 HMACについては、RFC 2104で規定されています。
Javaプラットフォームの実装は、すべて次の標準のMacアルゴリズムをサポートする必要があります。
- HmacMD5
- HmacSHA1
- HmacSHA256
これらのアルゴリズムについては、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのMacのセクションで説明されています。サポートされているその他のアルゴリズムについては、実装のリリース・ドキュメントを参照してください。
導入されたバージョン:

1.4

コンストラクタのサマリー

コンストラクタ
修飾子コンストラクタ説明

protected Mac(MacSpi macSpi, Provider provider, String algorithm)
MACオブジェクトを生成します。

コンストラクタ
修飾子	コンストラクタ	説明
`protected`	`Mac(MacSpi macSpi, Provider provider, String algorithm)`	MACオブジェクトを生成します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`Object`	`clone()`	プロバイダの実装が複製可能な場合は複製を返します。
`byte[]`	`doFinal()`	MAC操作を終了します。
`byte[]`	`doFinal(byte[] input)`	指定されたバイトの配列を処理してMAC操作を終了します。
`void`	`doFinal(byte[] output, int outOffset)`	MAC操作を終了します。
`String`	`getAlgorithm()`	この`Mac`オブジェクトのアルゴリズム名を返します。
`static Mac`	`getInstance(String algorithm)`	指定されたMACアルゴリズムを実装する`Mac`オブジェクトを返します。
`static Mac`	`getInstance(String algorithm, Provider provider)`	指定されたMACアルゴリズムを実装する`Mac`オブジェクトを返します。
`static Mac`	`getInstance(String algorithm, String provider)`	指定されたMACアルゴリズムを実装する`Mac`オブジェクトを返します。
`int`	`getMacLength()`	MACの長さをバイト単位で返します。
`Provider`	`getProvider()`	この`Mac`オブジェクトのプロバイダを返します。
`void`	`init(Key key)`	指定されたキーを使用してこの`Mac`オブジェクトを初期化します。
`void`	`init(Key key, AlgorithmParameterSpec params)`	指定されたキーとアルゴリズム・パラメータを使用してこの`Mac`オブジェクトを初期化します。
`void`	`reset()`	この`Mac`オブジェクトをリセットします。
`void`	`update(byte input)`	指定されたバイトを処理します。
`void`	`update(byte[] input)`	指定されたバイトの配列を処理します。
`void`	`update(byte[] input, int offset, int len)`	`input`内の`len`バイトを処理します。`offset`から始めます。
`void`	`update(ByteBuffer input)`	ByteBuffer `input`内の`input.position()`から始まる`input.remaining()`バイトを処理します。

クラス java.lang.Objectから継承されたメソッド
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - Mac
```
protected Mac(MacSpi macSpi,
              Provider provider,
              String algorithm)
```
    MACオブジェクトを生成します。
    
    パラメータ:
    
    macSpi - 委譲先
    
    provider - プロバイダ
    
    algorithm - アルゴリズム
- メソッドの詳細
  - getAlgorithm
```
public final String getAlgorithm()
```
    このMacオブジェクトのアルゴリズム名を返します。
    これは、このMacオブジェクトを作成したgetInstance呼出しのいずれかに指定された名前と同じです。
    
    戻り値:
    
    このMacオブジェクトのアルゴリズム名。
  - getInstance
```
public static final Mac getInstance(String algorithm)
                             throws NoSuchAlgorithmException
```
    指定されたMACアルゴリズムを実装するMacオブジェクトを返します。
    このメソッドは、最優先のProviderから順に、登録済みのセキュリティProviderのリストをトラバースします。指定されたアルゴリズムをサポートする最初のプロバイダからのMacSpiの実装をカプセル化する新しいMacオブジェクトが返されます。
    登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
    
    パラメータ:
    
    algorithm - 要求されたMACアルゴリズムの標準名。標準のアルゴリズム名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのMacのセクションを参照。
    
    戻り値:
    
    新しいMacオブジェクト。
    
    例外:
    
    NoSuchAlgorithmException - 指定したアルゴリズムのMacSpi実装をサポートするプロバイダが存在しない場合。
    
    関連項目:
    
    Provider
  - getInstance
```
public static final Mac getInstance(String algorithm,
                                    String provider)
                             throws NoSuchAlgorithmException,
                                    NoSuchProviderException
```
    指定されたMACアルゴリズムを実装するMacオブジェクトを返します。
    指定されたプロバイダからのMacSpi実装をカプセル化する新しいMacオブジェクトが返されます。指定したプロバイダは、セキュリティ・プロバイダ・リストに登録する必要があります。
    登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
    
    パラメータ:
    
    algorithm - 要求されたMACアルゴリズムの標準名。標準のアルゴリズム名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのMacのセクションを参照。
    
    provider - プロバイダ名
    
    戻り値:
    
    新しいMacオブジェクト。
    
    例外:
    
    NoSuchAlgorithmException - 指定されたプロバイダに指定されたアルゴリズムのMacSpiの実装がない場合。
    
    NoSuchProviderException - 指定されたプロバイダがセキュリティ・プロバイダ・リストに登録されていない場合
    
    IllegalArgumentException - providerがnullまたは空の場合
    
    関連項目:
    
    Provider
  - getInstance
```
public static final Mac getInstance(String algorithm,
                                    Provider provider)
                             throws NoSuchAlgorithmException
```
    指定されたMACアルゴリズムを実装するMacオブジェクトを返します。
    指定されたProviderオブジェクトからのMacSpi実装をカプセル化する新しいMacオブジェクトが返されます。指定されたProviderオブジェクトは、プロバイダ・リストに登録する必要はありません。
    
    パラメータ:
    
    algorithm - 要求されたMACアルゴリズムの標準名。標準のアルゴリズム名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのMacのセクションを参照。
    
    provider - プロバイダ
    
    戻り値:
    
    新しいMacオブジェクト。
    
    例外:
    
    NoSuchAlgorithmException - 指定されたProviderオブジェクトに指定されたアルゴリズムのMacSpiの実装がない場合。
    
    IllegalArgumentException - providerがnullの場合
    
    関連項目:
    
    Provider
  - getProvider
```
public final Provider getProvider()
```
    このMacオブジェクトのプロバイダを返します。
    
    戻り値:
    
    このMacオブジェクトのプロバイダ。
  - getMacLength
```
public final int getMacLength()
```
    MACの長さをバイト単位で返します。
    
    戻り値:
    
    バイト単位のMAC長
  - init
```
public final void init(Key key)
                throws InvalidKeyException
```
    指定されたキーを使用してこのMacオブジェクトを初期化します。
    
    パラメータ:
    
    key - キー
    
    例外:
    
    InvalidKeyException - 指定されたキーがこのMACの初期化に不適切な場合。
  - init
```
public final void init(Key key,
                       AlgorithmParameterSpec params)
                throws InvalidKeyException,
                       InvalidAlgorithmParameterException
```
    指定されたキーとアルゴリズム・パラメータを使用してこのMacオブジェクトを初期化します。
    
    パラメータ:
    
    key - キー
    
    params - アルゴリズム・パラメータ。
    
    例外:
    
    InvalidKeyException - 指定されたキーがこのMACの初期化に不適切な場合。
    
    InvalidAlgorithmParameterException - 指定されたアルゴリズム・パラメータがこのMACに不適切な場合。
  - update
```
public final void update(byte input)
                  throws IllegalStateException
```
    指定されたバイトを処理します。
    
    パラメータ:
    
    input - 処理される入力バイト。
    
    例外:
    
    IllegalStateException - このMacが初期化されていない場合。
  - update
```
public final void update(byte[] input)
                  throws IllegalStateException
```
    指定されたバイトの配列を処理します。
    
    パラメータ:
    
    input - 処理されるバイトの配列。
    
    例外:
    
    IllegalStateException - このMacが初期化されていない場合。
  - update
```
public final void update(byte[] input,
                         int offset,
                         int len)
                  throws IllegalStateException
```
    input内のlenバイトを処理します。offsetから始めます。
    
    パラメータ:
    
    input - 入力バッファ
    
    offset - 入力を開始するinput内のオフセット。
    
    len - 処理するバイト数。
    
    例外:
    
    IllegalStateException - このMacが初期化されていない場合。
  - update
```
public final void update(ByteBuffer input)
```
    ByteBuffer input内のinput.position()から始まるinput.remaining()バイトを処理します。終了時に、バッファの位置はリミットに等しくなりますが、リミットは変更されません。
    
    パラメータ:
    
    input - ByteBuffer
    
    例外:
    
    IllegalStateException - このMacが初期化されていない場合。
    
    導入されたバージョン:
    
    1.5
  - doFinal
```
public final byte[] doFinal()
                     throws IllegalStateException
```
    MAC操作を終了します。
    このメソッドを呼び出すと、このMacオブジェクトは、init(Key)またはinit(Key, AlgorithmParameterSpec)の呼出しを介して以前初期化された状態にリセットされます。つまり、オブジェクトは、必要に応じてupdateおよびdoFinalの新規の呼出しを介してリセットされ、同じキーから別のMACを生成するために使用可能になります。別のキーでこのMacオブジェクトを再使用するためには、init(Key)またはinit(Key, AlgorithmParameterSpec)の呼出しを介して再度初期化する必要があります。
    
    戻り値:
    
    MAC結果
    
    例外:
    
    IllegalStateException - このMacが初期化されていない場合。
  - doFinal
```
public final void doFinal(byte[] output,
                          int outOffset)
                   throws ShortBufferException,
                          IllegalStateException
```
    MAC操作を終了します。
    このメソッドを呼び出すと、このMacオブジェクトは、init(Key)またはinit(Key, AlgorithmParameterSpec)の呼出しを介して以前初期化された状態にリセットされます。つまり、オブジェクトは、必要に応じてupdateおよびdoFinalの新規の呼出しを介してリセットされ、同じキーから別のMACを生成するために使用可能になります。別のキーでこのMacオブジェクトを再使用するためには、init(Key)またはinit(Key, AlgorithmParameterSpec)の呼出しを介して再度初期化する必要があります。
    MAC結果はoutputに格納されます。outOffsetから始まります。
    
    パラメータ:
    
    output - MAC結果が格納されるバッファ
    
    outOffset - MACが格納されるoutput内のオフセット
    
    例外:
    
    ShortBufferException - 指定された出力バッファが小さすぎて結果を保持できない場合
    
    IllegalStateException - このMacが初期化されていない場合。
  - doFinal
```
public final byte[] doFinal(byte[] input)
                     throws IllegalStateException
```
    指定されたバイトの配列を処理してMAC操作を終了します。
    このメソッドを呼び出すと、このMacオブジェクトは、init(Key)またはinit(Key, AlgorithmParameterSpec)の呼出しを介して以前初期化された状態にリセットされます。つまり、オブジェクトは、必要に応じてupdateおよびdoFinalの新規の呼出しを介してリセットされ、同じキーから別のMACを生成するために使用可能になります。別のキーでこのMacオブジェクトを再使用するためには、init(Key)またはinit(Key, AlgorithmParameterSpec)の呼出しを介して再度初期化する必要があります。
    
    パラメータ:
    
    input - バイト単位のデータ
    
    戻り値:
    
    MAC結果
    
    例外:
    
    IllegalStateException - このMacが初期化されていない場合。
  - reset
```
public final void reset()
```
    このMacオブジェクトをリセットします。
    このメソッドを呼び出すと、このMacオブジェクトは、init(Key)またはinit(Key, AlgorithmParameterSpec)の呼出しを介して以前初期化された状態にリセットされます。つまり、オブジェクトは、必要に応じてupdateおよびdoFinalの新規の呼出しを介してリセットされ、同じキーから別のMACを生成するために使用可能になります。別のキーでこのMacオブジェクトを再使用するためには、init(Key)またはinit(Key, AlgorithmParameterSpec)の呼出しを介して再度初期化する必要があります。
  - clone
```
public final Object clone()
                   throws CloneNotSupportedException
```
    プロバイダの実装が複製可能な場合は複製を返します。
    
    オーバーライド:
    
    clone、クラスObject
    
    戻り値:
    
    プロバイダの実装が複製可能な場合は複製
    
    例外:
    
    CloneNotSupportedException - Cloneableをサポートしていない委譲先で呼び出された場合。
    
    関連項目:
    
    Cloneable

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスMac

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

Mac

メソッドの詳細

getAlgorithm

getInstance

getInstance

getInstance

getProvider

getMacLength

init

init

update

update

update

update

doFinal

doFinal

doFinal

reset

clone