java.nio.file.attribute

クラス UserPrincipalLookupService

java.lang.Object

java.nio.file.attribute.UserPrincipalLookupService

public abstract class UserPrincipalLookupService
extends Object

ユーザーおよびグループ主体を名前で検索するオブジェクトです。UserPrincipal は、ファイルシステム内のオブジェクトへのアクセス権を特定するために使用できる識別情報を表します。GroupPrincipal は、グループ識別情報を表します。UserPrincipalLookupService では、名前またはグループ名 (通常はユーザー名またはアカウント名) で識別情報を検索するメソッドを定義しています。名前やグループ名の大文字小文字を区別するかどうかは、実装によって異なります。グループの正確な定義は実装に固有のものですが、一般にグループはそのグループのメンバーのアクセス権を特定するために管理目的で作成された識別情報を表します。特に、名前とグループの名前空間が同じであるか異なるかは実装に固有のものです。プラットフォーム全体の動作の一貫性と正確性を確保するために、それらの名前空間がまったく異なるものであるかようにこの API を使用することをお勧めします。つまり、ユーザーの検索には lookupPrincipalByName を使用し、グループの検索には lookupPrincipalByGroupName を使用するようにしてください。

導入されたバージョン:

1.7

関連項目:

FileSystem.getUserPrincipalLookupService()

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

コンストラクタ

修飾子	コンストラクタと説明
protected	UserPrincipalLookupService() このクラスの新しいインスタンスを初期化します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract GroupPrincipal	lookupPrincipalByGroupName(String group) グループ主体をグループ名で検索します。
abstract UserPrincipal	lookupPrincipalByName(String name) ユーザー主体を名前で検索します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

UserPrincipalLookupService

protected UserPrincipalLookupService()

このクラスの新しいインスタンスを初期化します。

メソッドの詳細

lookupPrincipalByName

public abstract UserPrincipal lookupPrincipalByName(String name)
                                             throws IOException

ユーザー主体を名前で検索します。

パラメータ:

name - 検索するユーザー主体の文字列表現

戻り値:

ユーザー主体

例外:

UserPrincipalNotFoundException - その主体が存在しない場合

IOException - 入出力エラーが発生した場合

SecurityException - デフォルトプロバイダで、セキュリティーマネージャーがインストールされている場合は、RuntimePermission("lookupUserInformation")がチェックされます。

lookupPrincipalByGroupName

public abstract GroupPrincipal lookupPrincipalByGroupName(String group)
                                                   throws IOException

グループ主体をグループ名で検索します。

実装がグループの概念をまったくサポートしていない場合、このメソッドは常に UserPrincipalNotFoundException をスローします。ユーザーアカウントとグループの名前空間が同じ場合、このメソッドは lookupPrincipalByName を呼び出すことと同じです。

パラメータ:

group - 検索するグループの文字列表現

戻り値:

グループ主体

例外:

UserPrincipalNotFoundException - その主体が存在しないか、グループでない場合

IOException - 入出力エラーが発生した場合

SecurityException - デフォルトプロバイダで、セキュリティーマネージャーがインストールされている場合は、RuntimePermission("lookupUserInformation")がチェックされます。