com.github.mygreen.supercsv.cellprocessor.constraint

インタフェース RequiredWordProvider

機能インタフェース

これは機能インタフェースなので、ラムダ式またはメソッド参照の割当てターゲットとして使用できます。

@FunctionalInterface
public interface RequiredWordProvider

CsvWordRequireによる必須語彙のチェックを行う際の語彙を提供するためのインタフェースです。

語彙を別ファイルやDBから取得する時などサービスクラスとして実装します。

基本的な使い方は、 CsvWordRequireのJavaDocを参照してください。

フィールドごとにリソースを切り替えたい場合

フィールドごとにリソースを切り替えたい場合は、メソッドの引数FieldAccessorで判定を行います。

また、独自のパラメータを渡したい時は、独自のアノテーションを作成し、それをフィールドに付与して、 引数FieldAccessorから取得して判定します。

 // 読み込むリソースを定義されているフィールドやクラスで分ける場合
 public class FileRequiredWordProvider implements RequiredWordProvider {
     
     @Override
     public Collection<String> getRequiredWords(final FieldAccessor field) {
         
         final String path;
         if(field.getDeclaredClass().equals(AdminCsv.class)) {
             path = "required_word_admin.txt";
         } else {
             path = "required_word.txt";
         }
         
         try {
              return Files.readAllLines(new File(path).toPath(), Charset.forName("UTF-8"));
              
         } catch (IOException e) {
             throw new RuntimeException("fail reading the required words file.", e);
         }
         
     }
 }
 

Spring Frameworkと連携する場合

Springと連携している場合は、プロバイダクラスをSpringBeanとして登録しておくことでインジェクションできます。

また、メソッドgetRequiredWords(FieldAccessor)は、定義したフィールド単位に呼ばれるため、多数のフィールドで定義していると何度も呼ばれ、効率が悪くなる場合があります。
このようなときは、Spring Framework3.1から追加された Cache Abstraction(キャッシュの抽象化)機能を使うと改善できます。

 // SpringBeanとして登録する場合。
 @Service
 @Transactional
 public class RequiredWordProviderImpl implements RequiredWordProvider {
     
     // リポジトリのインジェクション
     @Autowired
     private RequiredWordRepository requiredWordRepository;
     
     @Override
     public Collection<String> getRequiredWords(final FieldAccessor field) {
         
         final Role role;
         if(field.getDeclaredClass().equals(AdminCsv.class)) {
             role = Role.admin;
         } else {
             role = Role.normal;
         }
         
         return loadWords(role).stream()
             .map(dto -> dto.getWord())
             .collect(Collectors.toList());
         
     }
     
     // リポジトリから取得した内容をキャッシュする。
     // 引数 role をキーにして、区別する。
     @Transactional(readOnly = true)
     @Cacheable(cacheNames="requiredWords", key="#role")
     public List<WordDto> loadWords(Role role) {
          
          if(role.euals(Role.admin)) {
              return requiredWordRepository.findByRole(role);
          } else {
              return requiredWordRepository.findAll();
          }
          
     }
 }
 

導入されたバージョン:

2.0

作成者:

T.TSUCHIE

メソッドのサマリー

修飾子とタイプ	メソッドと説明
Collection<String>	getRequiredWords(FieldAccessor field) 語彙の一覧を取得する。

メソッドの詳細

getRequiredWords

Collection<String> getRequiredWords(FieldAccessor field)

語彙の一覧を取得する。

パラメータ:

field - フィールド情報

戻り値:

語彙を返します。チェック対象の文字がない場合は、空のリストを返します。