net.siisise.bnf.parser.BNFBaseParser Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of softlib-abnf.module Show documentation
Java ABNF parser CC
The newest version!
/*
 * Copyright 2022 okome.
 *
 * Licensed 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 net.siisise.bnf.parser;

import java.nio.charset.StandardCharsets;
import net.siisise.block.ReadableBlock;
import net.siisise.bnf.BNF;
import net.siisise.io.FrontPacket;
import net.siisise.io.Input;

/**
 * AbstractBNFParserなのかもしれない.
 * 適度な処理だけしたもの
 * @param  変換後の型
 */
public abstract class BNFBaseParser implements BNFParser {
    
    protected BNF rule;

    /**
     * 上のparserから駆動される想定
     * @param rule 処理対象のABNF rule
     */
    protected BNFBaseParser(BNF rule) {
        this.rule = rule;
    }

    @Override
    public BNF getBNF() {
        return rule;
    }

    /**
     * パース
     * @param pac ソース
     * @param ns name space
     * @return パース結果
     */
    @Override
    public T parse(ReadableBlock pac, Object ns) {
        return parse(pac);
    }

    /**
     * パース.
     * ソースからは解析できた分だけ減る
     * @param pac ソース
     * @param ns 名前空間 name space
     * @return パース結果
     */
    @Override
    public T parse(FrontPacket pac, Object ns) {
        return parse(ReadableBlock.wrap(pac), ns);
    }

    @Override
    public T parse(FrontPacket pac) {
        return parse(ReadableBlock.wrap(pac), null);
    }

    @Override
    public T parse(String str, Object ns) {
        return parse(ReadableBlock.wrap(str), ns);
    }

    /**
     * 入り口
     * @param src 解析対象文字列
     * @return 変換されたデータ 不一致の場合はnull
     */
    @Override
    public T parse(String src) {
        return parse(ReadableBlock.wrap(src));
    }

    /**
     * バイト列をUTF-8文字列に変えるだけ。
     * pacは処理後空になる
     * 
     * @param pac バイト列
     * @return 文字列
     */
    protected static String str(Input pac) {
        return new String(pac.toByteArray(), StandardCharsets.UTF_8);
    }

    /**
     * バイト列をUTF-8文字列に変えるだけ。
     * pacは処理後空にならない
     * 
     * @param pac バイト列
     * @return 文字列
     */
    protected static String strd(ReadableBlock pac) {
        byte[] b = pac.toByteArray();
        pac.back(b.length);
        return new String(b, StandardCharsets.UTF_8);
    }
}