jm2darray.java

梦界家园程序开发基底框架

    }

    /**
     * 楍柤攝楍傪庢摼偡傞丅
     *
     * @return 楍柤攝楍
     */
    public synchronized String getColName (int aiCol) {
        return paColNames.get(aiCol);
    }

    /**
     * 设置列名
     * @param aiCol int
     * @param aColName String
     */
    public synchronized void setColName (int aiCol, String aColName) throws Exception {
        String sRegulatedName = aColName.toUpperCase();
        if (poColNameMap.containsKey(sRegulatedName)) {
            throw new Exception("列名[" + aColName + "]已经被使用");
        }
        paColNames.set(aiCol, aColName);
        poColNameMap.put(sRegulatedName, new Integer(aiCol));

    }

    /**
     * 设置列名（全体）
     */
    public synchronized void setColNames (JMVector<String> aColnames) throws Exception {
        if (aColnames != null && aColnames.size() == paColNames.size()) {
            paColNames = aColnames;
            for (int i = 0; i < aColnames.size(); i++) {
                String sRegulatedName = aColnames.get(i).toUpperCase();
                if (poColNameMap.containsKey(sRegulatedName)) {
                    throw new Exception("列名[" + sRegulatedName + "]已经被使用");
                }

                poColNameMap.put(sRegulatedName, new Integer(i));
            }
        }
    }

    /**
     * 设置列名（全体）
     */
    public synchronized void setColNames (String[] aColnames) throws Exception {
        if (aColnames != null && aColnames.length == paColNames.size()) {
            paColNames.clear();
            for (int i = 0; i < aColnames.length; i++) {
                paColNames.add(aColnames[i]);
                String sRegulatedName = aColnames[i].toUpperCase();
                if (poColNameMap.containsKey(sRegulatedName)) {
                    throw new Exception("列名[" + sRegulatedName + "]已经被使用");
                }
                poColNameMap.put(sRegulatedName, new Integer(i));
            }
        }
    }

    /**
     * 楍柤丒楍斣崋儅僢僾傪庢摼偡傞丅
     *
     * @return 楍柤儅僢僾
     */
    public synchronized JMMap<String, String> getColValue (int col) throws Exception {
        JMMap<String, String> val = new JMMap<String, String>();
        for (String key : paColNames) {
            val.put(key, getStringValue(col, key));
        }
        return val;
    }

    /**
     * 巜掕偝傟偨峴斣崋偵奩摉偡傞楍僨乕僞攝楍傪庢摼偡傞丅
     *
     * @param aiRow
     *            峴斣崋乮0 乣乯
     * @return 楍僨乕僞攝楍
     * @throws Exception
     *             晄惓側峴斣崋偑巜掕偝傟偨応崌
     */
    public synchronized JMVector<JMVal> getRow (int aiRow) throws Exception {
//        final String sMethod = "getRow";
        // 峴斣崋偼惓忢斖埻偐丠
        if (aiRow < 0 || aiRow >= rowCount()) {
            throw new Exception("峴斣崋[" + aiRow + "]偑晄惓偱偡");
        }
        // 巜掕峴偺楍僨乕僞攝楍傪庢摼偡傞
        return paRows.get(aiRow);
    }

    /**
     * 巜掕偝傟偨峴斣崋偵奩摉偡傞楍僨乕僞攝楍傪庢摼偡傞丅
     *
     * @param aiRow
     *            峴斣崋乮0 乣乯
     * @return 楍僨乕僞攝楍
     * @throws Exception
     *             晄惓側峴斣崋偑巜掕偝傟偨応崌
     */
    public synchronized JMVector<String> getRowData (int aiRow) throws Exception {
        // 峴斣崋偼惓忢斖埻偐丠
        if (aiRow < 0 || aiRow >= rowCount()) {
            throw new Exception("峴斣崋[" + aiRow + "]偑晄惓偱偡");
        }
        JMVector row = getColItemArray(aiRow);
        if (row == null)
            return null;
        JMVal icol = null;
        JMVector<String> coldate = new JMVector<String>();
        // 楍斣崋偵奩摉偡傞崁栚僨乕僞傪庢摼偡傞
        for (int i = 0; i < row.size(); i++) {
            icol = getItemObject(row, i);
            coldate.add(icol.getStringValue());
        }
        // 巜掕峴偺楍僨乕僞攝楍傪庢摼偡傞
        return coldate;

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵楍柤傪晅偗偰崁栚抣傪搊榐偡傞丅<BR>
     * 僆僽僕僃僋僩惗惉帪偺峴斣崋丄楍斣崋偼偲傕偵 0 偱偁傞丅
     *
     * @param asName
     *            楍柤
     * @param ayValue
     *            byte 宆崁栚抣
     * @throws Exception
     *             晄惓側楍柤乮嬻暥帤丄null乯傪巜掕偟偨応崌丄 楍柤枹巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌丄
     *             摨堦峴偵搊榐嵪傒楍柤傪巜掕偟偨応崌丄 婛搊榐峴偺摨堦楍偲堎側傞楍柤傪巜掕偟偨応崌
     */
    public synchronized void addItem (String asName, byte ayValue) throws Exception {
        // 楍柤傪惓婯壔偟偰搊榐偡傞
        registerColumnName(asName);
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(ayValue));
    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵崁栚抣傪搊榐偡傞丅
     *
     * @param ayValue
     *            byte 宆崁栚抣
     * @throws Exception
     *             楍柤巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌
     */
    public synchronized void addItem (byte ayValue) throws Exception {

        // 楍柤巊梡偺応崌丄椺奜傪憲弌偡傞
        if (hasNamedColumn()) {
            throw new Exception("重复列名出现");
        }
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(ayValue));

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵楍柤傪晅偗偰崁栚抣傪搊榐偡傞丅<BR>
     * 僆僽僕僃僋僩惗惉帪偺峴斣崋丄楍斣崋偼偲傕偵 0 偱偁傞丅
     *
     * @param asName
     *            楍柤
     * @param ahValue
     *            short 宆崁栚抣
     * @throws Exception
     *             晄惓側楍柤乮嬻暥帤丄null乯傪巜掕偟偨応崌丄 楍柤枹巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌丄
     *             摨堦峴偵搊榐嵪傒楍柤傪巜掕偟偨応崌丄 婛搊榐峴偺摨堦楍偲堎側傞楍柤傪巜掕偟偨応崌
     */
    public synchronized void addItem (String asName, short ahValue) throws Exception {
        // 楍柤傪惓婯壔偟偰搊榐偡傞
        registerColumnName(asName);
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(ahValue));
    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵崁栚抣傪搊榐偡傞丅
     *
     * @param ahValue
     *            short 宆崁栚抣
     * @throws Exception
     *             楍柤巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌
     */
    public synchronized void addItem (short ahValue) throws Exception {

        // 楍柤巊梡偺応崌丄椺奜傪憲弌偡傞
        if (hasNamedColumn()) {
            throw new Exception("重复列名出现");
        }
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(ahValue));

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵楍柤傪晅偗偰崁栚抣傪搊榐偡傞丅<BR>
     * 僆僽僕僃僋僩惗惉帪偺峴斣崋丄楍斣崋偼偲傕偵 0 偱偁傞丅
     *
     * @param asName
     *            楍柤
     * @param aiValue
     *            int 宆崁栚抣
     * @throws Exception
     *             晄惓側楍柤乮嬻暥帤丄null乯傪巜掕偟偨応崌丄 楍柤枹巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌丄
     *             摨堦峴偵搊榐嵪傒楍柤傪巜掕偟偨応崌丄 婛搊榐峴偺摨堦楍偲堎側傞楍柤傪巜掕偟偨応崌
     */
    public synchronized void addItem (String asName, int aiValue) throws Exception {

        // 楍柤傪惓婯壔偟偰搊榐偡傞
        registerColumnName(asName);
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(aiValue));

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵崁栚抣傪搊榐偡傞丅
     *
     * @param aiValue
     *            int 宆崁栚抣
     * @throws Exception
     *             楍柤巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌
     */
    public synchronized void addItem (int aiValue) throws Exception {

        // 楍柤巊梡偺応崌丄椺奜傪憲弌偡傞
        if (hasNamedColumn()) {
            throw new Exception("重复列名出现");
        }
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(aiValue));

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵楍柤傪晅偗偰崁栚抣傪搊榐偡傞丅<BR>
     * 僆僽僕僃僋僩惗惉帪偺峴斣崋丄楍斣崋偼偲傕偵 0 偱偁傞丅
     *
     * @param asName
     *            楍柤
     * @param alValue
     *            long 宆崁栚抣
     * @throws Exception
     *             晄惓側楍柤乮嬻暥帤丄null乯傪巜掕偟偨応崌丄 楍柤枹巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌丄
     *             摨堦峴偵搊榐嵪傒楍柤傪巜掕偟偨応崌丄 婛搊榐峴偺摨堦楍偲堎側傞楍柤傪巜掕偟偨応崌
     */
    public synchronized void addItem (String asName, long alValue) throws Exception {

        // 楍柤傪惓婯壔偟偰搊榐偡傞
        registerColumnName(asName);
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(alValue));

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵崁栚抣傪搊榐偡傞丅
     *
     * @param alValue
     *            long 宆崁栚抣
     * @throws Exception
     *             楍柤巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌
     */
    public synchronized void addItem (long alValue) throws Exception {

        // 楍柤巊梡偺応崌丄椺奜傪憲弌偡傞
        if (hasNamedColumn()) {
            throw new Exception("重复列名出现");
        }
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(alValue));

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵楍柤傪晅偗偰崁栚抣傪搊榐偡傞丅<BR>
     * 僆僽僕僃僋僩惗惉帪偺峴斣崋丄楍斣崋偼偲傕偵 0 偱偁傞丅
     *
     * @param asName
     *            楍柤
     * @param afValue
     *            float 宆崁栚抣
     * @throws Exception
     *             晄惓側楍柤乮嬻暥帤丄null乯傪巜掕偟偨応崌丄 楍柤枹巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌丄
     *             摨堦峴偵搊榐嵪傒楍柤傪巜掕偟偨応崌丄 婛搊榐峴偺摨堦楍偲堎側傞楍柤傪巜掕偟偨応崌
     */
    public synchronized void addItem (String asName, float afValue) throws Exception {

        // 楍柤傪惓婯壔偟偰搊榐偡傞
        registerColumnName(asName);
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(afValue));

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵崁栚抣傪搊榐偡傞丅
     *
     * @param afValue
     *            float 宆崁栚抣
     * @throws Exception
     *             楍柤巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌
     */
    public synchronized void addItem (float afValue) throws Exception {

        // 楍柤巊梡偺応崌丄椺奜傪憲弌偡傞
        if (hasNamedColumn()) {
            throw new Exception("重复列名出现");
        }
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(afValue));

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵楍柤傪晅偗偰崁栚抣傪搊榐偡傞丅<BR>
     * 僆僽僕僃僋僩惗惉帪偺峴斣崋丄楍斣崋偼偲傕偵 0 偱偁傞丅
     *
     * @param asName
     *            楍柤
     * @param adValue
     *            double 宆崁栚抣
     * @throws Exception
     *             晄惓側楍柤乮嬻暥帤丄null乯傪巜掕偟偨応崌丄 楍柤枹巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌丄
     *             摨堦峴偵搊榐嵪傒楍柤傪巜掕偟偨応崌丄 婛搊榐峴偺摨堦楍偲堎側傞楍柤傪巜掕偟偨応崌
     */
    public synchronized void addItem (String asName, double adValue) throws Exception {

        // 楍柤傪惓婯壔偟偰搊榐偡傞
        registerColumnName(asName);
        // 崁栚僆僽僕僃僋僩傪搊榐偡傞
        addItemBody(new JMVal(adValue));

    }

    /**
     * 僇儗儞僩峴偺愭摢楍偐傜弴斣偵崁栚抣傪搊榐偡傞丅
     *
     * @param adValue
     *            double 宆崁栚抣
     * @throws Exception
     *             楍柤巊梡愝掕偺僆僽僕僃僋僩偱屇傃弌偝傟偨応崌
     */