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.hayabusa.db;
017    
018    import org.opengion.fukurou.model.NativeType;
019    import org.opengion.fukurou.util.ErrorMessage;
020    
021    /**
022     * 繝??繧ｿ繝吶?繧ｹ縺ｮ繧ｫ繝ｩ繝?ｱ樊?縺ｮ縺?■縲?撕逧?ｫ也炊螻樊?繧定ｦ丞ｮ壹☆繧区ュ蝣ｱ繧剃ｿ晄戟縺励※縺?ｋ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶?
023     * 縺薙?繧､繝ｳ繧ｿ繝ｼ繝輔ぉ繝ｼ繧ｹ繧貞ｮ溯｣?＠縺溘け繝ｩ繧ｹ縺ｯ縲√き繝ｩ繝??蜷榊燕縲√Λ繝吶Ν縲∵｡∵焚縲?
024     * 遞ｮ鬘?譁?ｭ励?謨ｰ蟄励?譌･莉?繧?ち繧､繝?蜈ｨ隗偵?蜊願ｧ偵?螟ｧ譁?ｭ励?蟆乗枚蟄?縺ｮ諠??繧?
025     * 謖√▲縺ｦ縺?∪縺吶?縺輔ｉ縺ｫ縲√◎縺ｮ繧ｫ繝ｩ繝??陦ｨ遉ｺ譁ｹ豕?CellRenderer)繧??
026     * 邱ｨ髮?婿豕?CellEditor)繧帝撕逧?↓蜑ｲ繧雁ｽ薙※繧倶ｺ九′蜿ｯ閭ｽ縺ｧ縺吶?
027     * 縺薙ｌ繧峨??後き繝ｩ繝??髱咏噪諠??縺ｧ縺ゅ▲縺ｦ縲√◎縺ｮ繧ｫ繝ｩ繝?↓蟇ｾ縺吶ｋ蛟､繧剃ｿ晄戟縺励◆繧?
028     * 蜷?い繝励Μ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ豈弱↓螟画峩縺輔ｌ繧区ュ蝣ｱ縺ｯ謖√▲縺ｦ縺?∪縺帙ｓ縲ゅ☆縺ｹ縺ｦ縺ｮ逕ｻ髱｢縺ｧ
029     * 蜷御ｸ??諠??繧剃ｿ晄戟縺励※縺?∪縺吶?
030     * 繝??繧ｿ繧堤匳骭ｲ縺吶ｋ蝣ｴ蜷医?譛?ｽ朱剞縺ｮ謨ｴ蜷域?繝√ぉ繝?け縺ｯ縲√％縺ｮ繧ｯ繝ｩ繧ｹ繧堤畑縺?※
031     * 陦後＞縺ｾ縺吶?
032     * 繝√ぉ繝?け譁ｹ豕輔?縲∫ｨｮ鬘槭ｄ繧ｿ繧､繝励〒逡ｰ縺ｪ繧翫∪縺吶′?後◎繧後ｉ縺ｯ縺薙?繧､繝ｳ繧ｿ繝ｼ繝輔ぉ繝ｼ繧ｹ
033     * 繧貞ｮ溯｣?＠縺溘し繝悶け繝ｩ繧ｹ豈弱↓逡ｰ縺ｪ繧翫∪縺吶?
034     *
035     * @og.group 繝??繧ｿ螻樊?
036     *
037     * @version  4.0
038     * @author   Kazuhiko Hasegawa
039     * @since    JDK5.0,
040     */
041    public interface DBType {
042    
043            // 5.1.6.0 (2010/05/01) 蛻晄悄繧ｿ繧､繝励ｒ XK 縺ｨ縺励∪縺吶?
044            static final String DEF_TYPE = "XK" ;
045    
046    // 4.1.1.2 (2008/02/28) fukurou.model.NativeType縺ｫ遘ｻ蜍?
047    //      /** NATIVE縺ｮ蝙?[int] 縺ｮ隴伜挨繧ｳ繝ｼ繝?({@value})  */
048    //      static final int NATIVE_INT  = 0 ;
049    //
050    //      /** NATIVE縺ｮ蝙?[long] 縺ｮ隴伜挨繧ｳ繝ｼ繝?({@value})  */
051    //      static final int NATIVE_LONG  = 1 ;
052    //
053    //      /** NATIVE縺ｮ蝙?[double] 縺ｮ隴伜挨繧ｳ繝ｼ繝?({@value})  */
054    //      static final int NATIVE_DOUBLE  = 2 ;
055    //
056    //      /** NATIVE縺ｮ蝙?[String] 縺ｮ隴伜挨繧ｳ繝ｼ繝?({@value})  */
057    //      static final int NATIVE_STRING  = 3 ;
058    //
059    //      /** NATIVE縺ｮ蝙?[Calendar] 縺ｮ隴伜挨繧ｳ繝ｼ繝?({@value})  */
060    //      static final int NATIVE_CALENDAR  = 4 ;
061    
062            /**
063             * NATIVE縺ｮ蝙九?隴伜挨繧ｳ繝ｼ繝峨ｒ霑斐＠縺ｾ縺吶?
064             *
065             * @og.rev 3.5.4.7 (2004/02/06) 譁ｰ隕丈ｽ懈?
066             * @og.rev 4.1.1.2 (2008/02/28) Enum蝙?fukurou.model.NativeType)縺ｫ螟画峩
067             *
068             * @return  NATIVE縺ｮ蝙九?隴伜挨繧ｳ繝ｼ繝?DBType 縺ｧ隕丞ｮ?
069             * @see org.opengion.fukurou.model.NativeType
070             */
071            NativeType getNativeType() ;
072    
073            /**
074             * 譁?ｭ励ち繧､繝励↓蠢懊§縺滓婿豕輔〒蝗ｺ螳夐聞縺ｫ螟画鋤縺励◆譁?ｭ怜?繧定ｿ斐＠縺ｾ縺吶?
075             * 萓九∴縺ｰ?悟?隗偵↑繧牙?隗偵せ繝壹?繧ｹ縺ｧ縲∵焚蟄励ち繧､繝励↑繧峨ぞ繝ｭ蝓九ａ縺励∪縺吶?
076             *
077             * @og.rev 3.5.4.5 (2004/01/23) 繧ｨ繝ｳ繧ｳ繝ｼ繝画欠螳壹↓螟画峩縺励∪縺吶?
078             *
079             * @param   value    ?ｦ?ｩ?ｬ?ｬ蝓九ａ縺吶ｋ譁?ｭ怜?
080             * @param   sizeX    謨ｴ謨ｰ驛ｨ蛻??譁?ｭ怜?縺ｮ髟ｷ縺?
081             * @param   sizeY    蟆第焚驛ｨ蛻??譁?ｭ怜?縺ｮ髟ｷ縺?
082             * @param   encode   蝗ｺ螳夐聞縺ｧ螟画鋤縺吶ｋ譁?ｭ励お繝ｳ繧ｳ繝ｼ繝?
083             *
084             * @return  ?ｦ?ｩ?ｬ?ｬ蝓九ａ縺励◆譁ｰ縺励＞譁?ｭ怜?
085             */
086            String valueFill( String value ,int sizeX ,int sizeY,String encode ) ;
087    
088            /**
089             * 縺昴?DBType縺ｮ,繝?ヵ繧ｩ繝ｫ繝医?蛟､(迚ｩ逅?噪蛻晄悄險ｭ螳壼?)繧定ｿ斐＠縺ｾ縺吶?
090             *
091             * 荳?握縺ｫ縲∵枚蟄怜?縺ｮ蝣ｴ蜷医?,繧ｼ繝ｭ繧ｹ繝医Μ繝ｳ繧ｰ""  謨ｰ蟄励?蝣ｴ蜷医? "0" 縺ｧ縺吶?
092             *
093             * @return  迚ｩ逅?噪蛻晄悄險ｭ螳壼?
094             */
095            String getDefault() ;
096    
097            /**
098             * String蠑墓焚縺ｮ譁?ｭ怜?繧抵ｼ具ｼ代＠縺滓枚蟄怜?繧定ｿ斐＠縺ｾ縺吶?
099             * 縺薙ｌ縺ｯ縲∬恭蟄励?蝣ｴ蜷?A,B,C 縺ｪ縺ｩ)縺ｯ縲。,C,D 縺ｮ繧医≧縺ｫ,譛?ｵよ｡√?譁?ｭ励さ繝ｼ繝峨ｒ
100             * ?具ｼ?縺励∪縺吶?
101             * 譁?ｭ怜?縺梧焚蟄励ち繧､繝励?蝣ｴ蜷医?, 謨ｰ蟄励↓螟画鋤縺励※縲?1 縺励∪縺吶?(譯∽ｸ翫′繧翫ｂ縺ゅｊ)
102             * 豺ｷ蝨ｨ繧ｿ繧､繝励?蝣ｴ蜷医?,譛?ｾ後?譯√□縺代ｒ遒ｺ隱阪＠縺ｦ ?具ｼ代＠縺ｾ縺吶?
103             * 蠑墓焚縺?null 縺ｮ蝣ｴ蜷医→縲√ぞ繝ｭ譁?ｭ怜?("")縺ｮ蝣ｴ蜷医?,迚ｩ逅?噪蛻晄悄險ｭ螳壼?(String getDefault())
104             * 縺ｮ蛟､繧定ｿ斐＠縺ｾ縺吶?
105             *
106             * @param   value  String蠑墓焚
107             *
108             * @return  蠑墓焚縺ｮ譁?ｭ怜?繧抵ｼ具ｼ代＠縺滓枚蟄怜?縲?
109             */
110            String valueAdd( String value ) ;
111    
112            /**
113             * String蠑墓焚縺ｮ譁?ｭ怜?縺ｫ縲∫ｬｬ?貞ｼ墓焚縺ｫ謖?ｮ壹?譁?ｭ怜?(謨ｰ蟄励?譌･莉倡ｭ?繧貞刈邂励＠縺ｦ霑斐＠縺ｾ縺吶?
114             *
115             * 縺薙ｌ縺ｯ縲」alueAdd( String ) 縺ｨ譛ｬ雉ｪ逧?↓縺ｯ蜷後§蜍輔″繧偵＠縺ｾ縺吶′縲∽ｻｻ諢上?譁?ｭ怜?繧貞刈邂励☆繧?
116             * 縺溘ａ縲∽ｸｻ縺ｨ縺励※縲∵焚蟄礼ｳｻ繧?律莉倡ｳｻ縺ｮ DBType 縺ｫ縺ｮ縺ｿ螳溯｣?＠縺ｾ縺吶?
117             * 螳溯｣?′縺ｪ縺??蜷医?縲ゞnsupportedOperationException 繧?throw 縺励∪縺吶?
118             * 
119             * 隨ｬ?貞ｼ墓焚 縺後?null 縺ｮ蝣ｴ蜷医?縲?ｼ具ｼ?縺吶ｋ valueAdd( String )縺悟他縺ｰ繧後∪縺吶?
120             * 縺薙ｌ縺ｯ縲∝ｰ?擂逧?↓縺ｯ縲」alueAdd( String ) 繧堤┌縺上☆縺薙→繧呈э蜻ｳ縺励∪縺吶?
121             *
122             * @og.rev 5.6.0.3 (2012/01/24) ADD 縺ｫ縲∝ｼ墓焚縺ｮ蛟､繧貞刈邂励☆繧区ｩ溯?繧定ｿｽ蜉?＠縺ｾ縺吶?
123             *
124             * @param   value  String蠑墓焚
125             * @param   add    蜉?ｮ励☆繧区枚蟄怜?(null 縺ｮ蝣ｴ蜷医?縲∝ｾ捺擂縺ｨ蜷後§縲?1 縺励∪縺吶?)
126             *
127             * @return  蠑墓焚縺ｮ譁?ｭ怜?隨ｬ?貞ｼ墓焚縺ｫ謖?ｮ壹?譁?ｭ怜?(謨ｰ蟄励?譌･莉倡ｭ?繧貞刈邂励＠縺滓枚蟄怜?縲?
128             * @throws UnsupportedOperationException 螳溯｣?′蟄伜惠縺励↑縺??蜷?
129             */
130            String valueAdd( final String value,final String add ) ;
131    
132            /**
133             * 繧ｨ繝?ぅ繧ｿ繝ｼ縺ｧ邱ｨ髮?＆繧後◆繝??繧ｿ繧堤匳骭ｲ縺吶ｋ蝣ｴ蜷医↓縲√ョ繝ｼ繧ｿ縺昴?繧ゅ?繧?
134             * 螟画鋤縺励※縲∝ｮ溽匳骭ｲ繝??繧ｿ繧剃ｽ懈?縺励∪縺吶?
135             * 萓九∴縺ｰ,螟ｧ譁?ｭ励?縺ｿ縺ｮ繝輔ぅ繝ｼ繝ｫ繝峨↑繧峨?螟ｧ譁?ｭ怜喧縺励∪縺吶?
136             * 螳溽匳骭ｲ繝??繧ｿ縺ｮ菴懈?縺ｯ縲．BType 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ蛻ｩ逕ｨ縺励∪縺吶?縺ｧ,
137             * 縺薙ｌ縺ｨ CellEditor 縺ｨ縺後い繝ｳ繝槭ャ繝√?蝣ｴ蜷医?縲√≧縺ｾ縺上ョ繝ｼ繧ｿ螟画鋤
138             * 縺輔ｌ縺ｪ縺?庄閭ｽ諤ｧ縺後≠繧翫∪縺吶?縺ｧ縲∵ｳｨ諢城｡倥＞縺ｾ縺吶?
139             *
140             * @param       value   (荳?握縺ｫ邱ｨ髮?ョ繝ｼ繧ｿ縺ｨ縺励※逋ｻ骭ｲ縺輔ｌ縺溘ョ繝ｼ繧ｿ)
141             *
142             * @return  菫ｮ豁｣蠕後?譁?ｭ怜?(荳?握縺ｫ繝??繧ｿ繝吶?繧ｹ縺ｫ逋ｻ骭ｲ縺吶ｋ繝??繧ｿ)
143             */
144            String valueSet( String value ) ;
145    
146            /**
147             * action 縺ｧ謖?ｮ壹＆繧後◆繧ｳ繝槭Φ繝峨ｒ螳溯｡後＠縺ｦ縲∝?縺ｮ螟画鋤繧定｡後＞縺ｾ縺吶?
148             * oldValue(譌ｧ繝??繧ｿ)縺ｯ縲∝?縺ｮDBTableModel縺ｫ險ｭ螳壹＆繧後※縺?◆蛟､縺ｧ縺吶?騾壼ｸｸ縺ｯ縲?
149             * 縺薙?蛟､繧剃ｽｿ逕ｨ縺励※繧ｫ繝ｩ繝?ｯ弱↓螟画鋤繧定｡後＞縺ｾ縺吶?newValue(譁ｰ繝??繧ｿ)縺ｯ縲∝ｼ墓焚縺ｧ
150             * 謖?ｮ壹＆繧後◆譁ｰ縺励＞蛟､縺ｧ縺吶?縺薙?蛟､縺ｫ縺ｯ縲√ヱ繝ｩ繝｡繝ｼ繧ｿ繧呈欠螳壹＠縺ｦ螟画鋤譁ｹ豕輔ｒ
151             * 蛻ｶ蠕｡縺吶ｋ縺薙→繧ょ庄閭ｽ縺ｧ縺吶?
152             * 謖?ｮ壹?繧｢繧ｯ繧ｷ繝ｧ繝ｳ縺後き繝ｩ繝?〒蜃ｦ逅?〒縺阪↑縺??蜷医?縲√お繝ｩ繝ｼ縺ｫ縺ｪ繧翫∪縺吶?
153             *
154             * @param action        繧｢繧ｯ繧ｷ繝ｧ繝ｳ繧ｳ繝槭Φ繝?
155             * @param oldValue      蜈･蜉帙ョ繝ｼ繧ｿ(譌ｧ繝??繧ｿ)
156             * @param newValue      蜈･蜉帙ョ繝ｼ繧ｿ(譁ｰ繝??繧ｿ)
157             *
158             * @return      螳溯｡悟ｾ後?繝??繧ｿ
159             */
160            String valueAction( String action,String oldValue,String newValue ) ;
161    
162            /**
163             * 繝??繧ｿ縺檎匳骭ｲ蜿ｯ閭ｽ縺九←縺?°繧偵メ繧ｧ繝?け縺励∪縺吶?
164             * 繝??繧ｿ縺後お繝ｩ繝ｼ縺ｮ蝣ｴ蜷医?縲√◎縺ｮ繧ｨ繝ｩ繝ｼ蜀?ｮｹ繧定ｿ斐＠縺ｾ縺吶?
165             *
166             * @og.rev 3.6.0.0 (2004/09/22) dbType 繝代Λ繝｡繝ｼ繧ｿ繧貞ｼ墓焚縺ｫ霑ｽ蜉?
167             * @og.rev 5.2.2.0 (2010/11/01) 蜴ｳ蟇?↓繝√ぉ繝?け(isStrict=true)縺吶ｋ繝輔Λ繧ｰ繧定ｿｽ蜉?
168             *
169             * @param   key                 繧ｭ繝ｼ
170             * @param   value               蛟､
171             * @param   sizeX               謨ｴ謨ｰ驛ｨ蛻??譁?ｭ怜?縺ｮ髟ｷ縺?
172             * @param   sizeY               蟆第焚驛ｨ蛻??譁?ｭ怜?縺ｮ髟ｷ縺?
173             * @param   typeParam   dbType 繝代Λ繝｡繝ｼ繧ｿ
174             * @param   isStrict    蜴ｳ蟇?↓繝√ぉ繝?け縺吶ｋ縺九←縺?° [true:縺吶ｋ/false:讓呎ｺ也噪]
175             *
176             * @return  繧ｨ繝ｩ繝ｼ蜀?ｮｹ
177             */
178    //      ErrorMessage valueCheck( String key ,String value ,int sizeX ,int sizeY,String typeParam ) ;
179            ErrorMessage valueCheck( String key ,String value ,int sizeX ,int sizeY ,String typeParam ,boolean isStrict ) ;
180    }