001    /*
002     * Copyright (c) 2009 The openGion Project.
003     *
004     * Licensed under the Apache License, Version 2.0 (the "License");
005     * you may not use this file except in compliance with the License.
006     * You may obtain a copy of the License at
007     *
008     *     http://www.apache.org/licenses/LICENSE-2.0
009     *
010     * Unless required by applicable law or agreed to in writing, software
011     * distributed under the License is distributed on an "AS IS" BASIS,
012     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
013     * either express or implied. See the License for the specific language
014     * governing permissions and limitations under the License.
015     */
016    package org.opengion.plugin.column;
017    
018    import org.opengion.fukurou.util.StringUtil;
019    import org.opengion.hayabusa.db.AbstractDBType;
020    
021    /**
022     * Unicode譁?ｭ怜?縺ｮ蛟､繧?HTML 縺ｮ繧ｨ繧ｹ繧ｱ繝ｼ繝苓ｨ伜捷(&amp;#xZZZZ;)縺ｫ螟画鋤縺吶ｋ縲√き繝ｩ繝?ｱ樊?繧貞ｮ夂ｾｩ縺励∪縺吶?
023     *
024     * SJIS(JA16SJIS) 縺ｧ菴懈?縺輔ｌ縺溘ョ繝ｼ繧ｿ繝吶?繧ｹ縺ｫ縲?NVARCHAR2)繧剃ｽｿ逕ｨ縺励※荳ｭ蝗ｽ隱樒ｭ峨ｒ逋ｻ骭ｲ縺吶ｋ縺ｮ縺ｯ
025     * 髱槫ｸｸ縺ｫ隍?尅縺ｧ縺九▽縲√Μ繧ｹ繧ｯ縺悟､ｧ縺阪＞蜃ｦ逅?↓縺ｪ繧翫∪縺吶?
026     * ORACLE谿ｿ縺ｧ繧ゅ?閾ｪ菫｡繧呈戟縺｣縺ｦ縺ｯ蜍ｧ繧√ｉ繧後↑縺?ｩ溯?縺ｨ縺ｮ繧ｳ繝｡繝ｳ繝医ｒ鬆ゅ＞縺ｦ縺?∪縺吶?
027     * 縺昴％縺ｧ縲？TML縺ｧ縺ｮ繧ｨ繧ｹ繧ｱ繝ｼ繝玲枚蟄励ｒ菴ｿ逕ｨ縺励※縲ゞnicode繧呈枚蟄怜?蛹悶＠縺ｦ逋ｻ骭ｲ縺吶ｋ轤ｺ縺ｮ
028     * DBType 縺ｨ縺励※縲∵眠隕上↓菴懈?縺励∪縺吶?
029     * 縺薙％縺ｧ縺ｯ縲∝?蜉帶枚蟄励ｒ縲√く繝｣繝ｩ繧ｯ繧ｿ(char)蝙九↓蛻?ｧ｣縺励?(&amp;#xZZZZ;)縺ｫ螟画鋤縺励※縺?″縺ｾ縺吶?
030     * 繧医▲縺ｦ縲??蟶ｸ縺ｫ?第枚蟄?Shift-JIS縺ｧ?達yte,UTF-8縺ｧ?釘yte)縺後??錬yte縺ｫ縺ｪ繧翫∪縺吶?
031     * 縺薙?螟画鋤縺輔ｌ縺滓枚蟄怜?繧偵?HTML荳翫〒縺昴?縺ｾ縺ｾ蜿悶ｊ蜃ｺ縺吶→縲∝?縺ｮUnicode譁?ｭ励↓謌ｻ繧狗ぜ縲?
032     * 騾壼ｸｸ縺ｮShift-JIS縺ｧ縺ｯ縲∵桶縺医↑縺?枚蟄?荳ｭ蝗ｽ隱槭↑縺ｩ)縺ｧ繧り｡ｨ遉ｺ蜿ｯ閭ｽ縺ｫ縺ｪ繧翫∪縺吶?
033     *
034     * (NVARCHAR2)繧剃ｽｿ逕ｨ縺励※荳ｭ蝗ｽ隱樒ｭ峨ｒ逋ｻ骭ｲ縺吶ｋ蝣ｴ蜷医?譁?ｭ励さ繝ｼ繝牙､画鋤
035     *
036     * AP繝ｬ繧､繝､     繝阪ャ繝医Ξ繧､繝､                        DB繝ｬ繧､繝､
037     * 譁?ｭ怜?蜉? 竊?蜈ｨ縺ｦDB縺ｮCHAR繧ｻ繝?ヨ縺ｫ螟画鋤  竊? NCHAR縺ｮ蛻?□縺繕TF縺ｫ螟画鋤
038     * (UTF)      (S-jis)                         (UTF)
039     *
040     * 繧ｿ繧､繝励メ繧ｧ繝?け縺ｯ縲？TML縺ｮ繧ｨ繧ｹ繧ｱ繝ｼ繝苓ｨ伜捷(&amp;#xZZZZ;)縺ｫ螟画鋤蠕後↓螳滓命縺輔ｌ縺ｾ縺吶?
041     * 繝??繧ｿ繝吶?繧ｹ縺ｸ縺ｮ逋ｻ骭ｲ縺ｫ縺ｯ縲∝濠隗定恭謨ｰ蟄励↓縺ｪ繧翫∪縺吶?
042     * 繝ｻ譁?ｭ怜?髟ｷ縺ｯ縲。yte謠帷ｮ励〒縺ｮ譁?ｭ玲焚縺ｨ縺ｮ豈碑ｼ?
043     * 繝ｻ蜊願ｧ呈枚蟄怜?繝√ぉ繝?け縲?c &lt; 0x20 || c &gt; 0x7e 莉･螟悶?繧ｨ繝ｩ繝ｼ
044     * 繝ｻ譁?ｭ励ヱ繝ｩ繝｡繝ｼ繧ｿ縺ｮ 豁｣隕剰｡ｨ迴ｾ繝√ぉ繝?け
045     * 繝ｻ繧ｯ繝ｭ繧ｹ繧ｵ繧､繝医せ繧ｯ繝ｪ繝励ユ繧｣繝ｳ繧ｰ繝√ぉ繝?け
046     *
047     * @og.rev 3.8.0.0 (2005/06/07) 譁ｰ隕丈ｽ懈?
048     * @og.group 繝??繧ｿ螻樊?
049     *
050     * @version  4.0
051     * @author       Kazuhiko Hasegawa
052     * @since    JDK5.0,
053     */
054    public class DBType_NVAR extends AbstractDBType {
055            //* 縺薙?繝励Ο繧ｰ繝ｩ繝??VERSION譁?ｭ怜?繧定ｨｭ螳壹＠縺ｾ縺吶?       {@value} */
056            private static final String VERSION = "4.0.0.0 (2005/08/31)" ;
057    
058            /**
059             * 蜊願ｧ抵ｼ先枚蟄励?蝗ｺ螳夐聞縺ｧFILL蝓九ａ縺輔ｌ縺滓枚蟄怜?繧定ｿ斐＠縺ｾ縺吶?
060             * 縺ｪ縺翫?繧ｨ繝ｩ繝ｼ繝√ぉ繝?け縺ｯ陦後ｏ繧後∪縺帙ｓ縲?
061             * 螳溯｡悟燕縺ｫ縲∝ｿ?★ valueCheck( String value ,int len ) 縺瑚｡後ｏ繧後ｋ蠢?ｦ√′縺ゅｊ縺ｾ縺吶?
062             *
063             * @param       value    ?ｦ?ｩ?ｬ?ｬ蝓九ａ縺吶ｋ譁?ｭ怜?
064             * @param       sizeX    謨ｴ謨ｰ驛ｨ蛻??譁?ｭ怜?縺ｮ髟ｷ縺?
065             * @param       sizeY    蟆第焚驛ｨ蛻??譁?ｭ怜?縺ｮ髟ｷ縺?
066             * @param       encode   繧ｨ繝ｳ繧ｳ繝ｼ繝画欠螳?
067             *
068             * @return      ?ｦ?ｩ?ｬ?ｬ蝓九ａ縺励◆譁ｰ縺励＞譁?ｭ怜?
069             */
070            @Override
071            public String valueFill( final String value ,final int sizeX ,final int sizeY,final String encode ) {
072                    return valueSet( super.valueFill( value,sizeX,sizeY,encode ) );
073            }
074    
075            /**
076             * String蠑墓焚縺ｮ譁?ｭ怜?繧抵ｼ具ｼ代＠縺滓枚蟄怜?繧定ｿ斐＠縺ｾ縺吶?
077             * 縺薙ｌ縺ｯ縲∬恭蟄励?蝣ｴ蜷?A,B,C 縺ｪ縺ｩ)縺ｯ縲。,C,D 縺ｮ繧医≧縺ｫ,譛?ｵよ｡√?譁?ｭ励さ繝ｼ繝峨ｒ
078             * ?具ｼ?縺励∪縺吶?
079             * 譁?ｭ怜?縺梧焚蟄励ち繧､繝励?蝣ｴ蜷医?, 謨ｰ蟄励↓螟画鋤縺励※縲?1 縺励∪縺吶?(譯∽ｸ翫′繧翫ｂ縺ゅｊ)
080             * 豺ｷ蝨ｨ繧ｿ繧､繝励?蝣ｴ蜷医?,譛?ｾ後?譯√□縺代ｒ遒ｺ隱阪＠縺ｦ ?具ｼ代＠縺ｾ縺吶?
081             * 蠑墓焚縺?null 縺ｮ蝣ｴ蜷医→縲√ぞ繝ｭ譁?ｭ怜?("")縺ｮ蝣ｴ蜷医?,迚ｩ逅?噪蛻晄悄險ｭ螳壼?(String getDefault())
082             * 縺ｮ蛟､繧定ｿ斐＠縺ｾ縺吶?
083             *
084             * @param       value   String蠑墓焚縺ｮ譁?ｭ怜?
085             *
086             * @return      String蠑墓焚縺ｮ譁?ｭ怜?繧抵ｼ具ｼ代＠縺滓枚蟄怜?
087             */
088            @Override
089            public String valueAdd( final String value ) {
090                    return valueSet( super.valueAdd( value ) );
091            }
092    
093            /**
094             * 繧ｨ繝?ぅ繧ｿ繝ｼ縺ｧ邱ｨ髮?＆繧後◆繝??繧ｿ繧堤匳骭ｲ縺吶ｋ蝣ｴ蜷医↓縲√ョ繝ｼ繧ｿ縺昴?繧ゅ?繧?
095             * 螟画鋤縺励※縲∝ｮ溽匳骭ｲ繝??繧ｿ繧剃ｽ懈?縺励∪縺吶?
096             * 萓九∴縺ｰ,螟ｧ譁?ｭ励?縺ｿ縺ｮ繝輔ぅ繝ｼ繝ｫ繝峨↑繧峨?螟ｧ譁?ｭ怜喧縺励∪縺吶?
097             * 螳溽匳骭ｲ繝??繧ｿ縺ｮ菴懈?縺ｯ縲．BType 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ蛻ｩ逕ｨ縺励∪縺吶?縺ｧ,
098             * 縺薙ｌ縺ｨ Editor 縺ｨ縺後い繝ｳ繝槭ャ繝√?蝣ｴ蜷医?縲√≧縺ｾ縺上ョ繝ｼ繧ｿ螟画鋤
099             * 縺輔ｌ縺ｪ縺?庄閭ｽ諤ｧ縺後≠繧翫∪縺吶?縺ｧ縲∵ｳｨ諢城｡倥＞縺ｾ縺吶?
100             *
101             * @param       value   (荳?握縺ｫ邱ｨ髮?ョ繝ｼ繧ｿ縺ｨ縺励※逋ｻ骭ｲ縺輔ｌ縺溘ョ繝ｼ繧ｿ)
102             *
103             * @return      菫ｮ豁｣蠕後?譁?ｭ怜?(荳?握縺ｫ繝??繧ｿ繝吶?繧ｹ縺ｫ逋ｻ骭ｲ縺吶ｋ繝??繧ｿ)
104             */
105            @Override
106            public String valueSet( final String value ) {
107                    return StringUtil.getUnicodeEscape( value );
108            }
109    }