| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You under the Apache License, Version 2.0 |
| * (the "License"); you may not use this file except in compliance with |
| * the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| package org.apache.lucene.analysis.ko; |
| |
| import java.io.IOException; |
| import java.io.InputStream; |
| import java.io.InputStreamReader; |
| import java.io.Reader; |
| import java.nio.charset.Charset; |
| import java.nio.charset.CharsetDecoder; |
| import java.nio.charset.CodingErrorAction; |
| import java.util.Locale; |
| import java.util.Map; |
| import org.apache.lucene.analysis.TokenizerFactory; |
| import org.apache.lucene.analysis.ko.KoreanTokenizer.DecompoundMode; |
| import org.apache.lucene.analysis.ko.dict.UserDictionary; |
| import org.apache.lucene.util.AttributeFactory; |
| import org.apache.lucene.util.IOUtils; |
| import org.apache.lucene.util.ResourceLoader; |
| import org.apache.lucene.util.ResourceLoaderAware; |
| |
| /** |
| * Factory for {@link KoreanTokenizer}. |
| * |
| * <pre class="prettyprint"> |
| * <fieldType name="text_ko" class="solr.TextField"> |
| * <analyzer> |
| * <tokenizer class="solr.KoreanTokenizerFactory" |
| * decompoundMode="discard" |
| * userDictionary="user.txt" |
| * userDictionaryEncoding="UTF-8" |
| * outputUnknownUnigrams="false" |
| * discardPunctuation="true" |
| * /> |
| * </analyzer> |
| * </fieldType> |
| * </pre> |
| * |
| * <p>Supports the following attributes: |
| * |
| * <ul> |
| * <li>userDictionary: User dictionary path. |
| * <li>userDictionaryEncoding: User dictionary encoding. |
| * <li>decompoundMode: Decompound mode. Either 'none', 'discard', 'mixed'. Default is discard. See |
| * {@link DecompoundMode} |
| * <li>outputUnknownUnigrams: If true outputs unigrams for unknown words. |
| * <li>discardPunctuation: true if punctuation tokens should be dropped from the output. |
| * </ul> |
| * |
| * @lucene.experimental |
| * @since 7.4.0 |
| * @lucene.spi {@value #NAME} |
| */ |
| public class KoreanTokenizerFactory extends TokenizerFactory implements ResourceLoaderAware { |
| |
| /** SPI name */ |
| public static final String NAME = "korean"; |
| |
| private static final String USER_DICT_PATH = "userDictionary"; |
| private static final String USER_DICT_ENCODING = "userDictionaryEncoding"; |
| private static final String DECOMPOUND_MODE = "decompoundMode"; |
| private static final String OUTPUT_UNKNOWN_UNIGRAMS = "outputUnknownUnigrams"; |
| private static final String DISCARD_PUNCTUATION = "discardPunctuation"; |
| |
| private final String userDictionaryPath; |
| private final String userDictionaryEncoding; |
| private UserDictionary userDictionary; |
| |
| private final KoreanTokenizer.DecompoundMode mode; |
| private final boolean outputUnknownUnigrams; |
| private final boolean discardPunctuation; |
| |
| /** Creates a new KoreanTokenizerFactory */ |
| public KoreanTokenizerFactory(Map<String, String> args) { |
| super(args); |
| userDictionaryPath = args.remove(USER_DICT_PATH); |
| userDictionaryEncoding = args.remove(USER_DICT_ENCODING); |
| mode = |
| KoreanTokenizer.DecompoundMode.valueOf( |
| get(args, DECOMPOUND_MODE, KoreanTokenizer.DEFAULT_DECOMPOUND.toString()) |
| .toUpperCase(Locale.ROOT)); |
| outputUnknownUnigrams = getBoolean(args, OUTPUT_UNKNOWN_UNIGRAMS, false); |
| discardPunctuation = getBoolean(args, DISCARD_PUNCTUATION, true); |
| |
| if (!args.isEmpty()) { |
| throw new IllegalArgumentException("Unknown parameters: " + args); |
| } |
| } |
| |
| /** Default ctor for compatibility with SPI */ |
| public KoreanTokenizerFactory() { |
| throw defaultCtorException(); |
| } |
| |
| @Override |
| public void inform(ResourceLoader loader) throws IOException { |
| if (userDictionaryPath != null) { |
| try (InputStream stream = loader.openResource(userDictionaryPath)) { |
| String encoding = userDictionaryEncoding; |
| if (encoding == null) { |
| encoding = IOUtils.UTF_8; |
| } |
| CharsetDecoder decoder = |
| Charset.forName(encoding) |
| .newDecoder() |
| .onMalformedInput(CodingErrorAction.REPORT) |
| .onUnmappableCharacter(CodingErrorAction.REPORT); |
| Reader reader = new InputStreamReader(stream, decoder); |
| userDictionary = UserDictionary.open(reader); |
| } |
| } else { |
| userDictionary = null; |
| } |
| } |
| |
| @Override |
| public KoreanTokenizer create(AttributeFactory factory) { |
| return new KoreanTokenizer( |
| factory, userDictionary, mode, outputUnknownUnigrams, discardPunctuation); |
| } |
| } |