java.lang.Object
java.nio.file.attribute.UserPrincipalLookupService
public abstract class UserPrincipalLookupService extends Object
ユーザーおよびグループ主体を名前で検索するオブジェクトです。
UserPrincipal
は、ファイル・システム内のオブジェクトへのアクセス権を特定するために使用できる識別情報を表します。 GroupPrincipal
は、グループ識別情報を表します。 UserPrincipalLookupService
では、名前またはグループ名(通常はユーザー名またはアカウント名)で識別情報を検索するメソッドを定義しています。 名前やグループ名の大文字小文字を区別するかどうかは、実装によって異なります。 グループの正確な定義は実装に固有のものですが、一般にグループはそのグループのメンバーのアクセス権を特定するために管理目的で作成された識別情報を表します。 特に、名前とグループの名前空間が同じであるか異なるかは実装に固有のものです。 プラットフォーム全体の動作の一貫性と正確性を確保するために、それらの名前空間がまったく異なるものであるかようにこのAPIを使用することをお薦めします。 つまり、ユーザーの検索にはlookupPrincipalByName
を使用し、グループの検索にはlookupPrincipalByGroupName
を使用するようにしてください。 - 導入されたバージョン:
- 1.7
- 関連項目:
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明abstract GroupPrincipal
lookupPrincipalByGroupName
(String group) グループ主体をグループ名で検索します。abstract UserPrincipal
lookupPrincipalByName
(String name) ユーザー主体を名前で検索します。
-
コンストラクタの詳細
-
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")
がチェックされます。
-