jmfolder.java

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

    /**
     * 僇儗儞僩僼僅儖僟偵崁栚柤偲崁栚抣傪巜掕偟偰崁栚僆僽僕僃僋僩傪搊榐偡傞丅
     * @param  asName		崁栚柤
     * @param  aoValue		<tt>JM2DArray</tt> 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							巜掕僼僅儖僟偵摨堦崁栚柤偺崁栚偑搊榐嵪傒偺応崌
     */
    public void addItem (String asName, JM2DArray aoValue) throws
            Exception {
        addItem(psCurrentFolder, asName, aoValue);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偵崁栚柤偲崁栚抣傪巜掕偟偰崁栚僆僽僕僃僋僩傪搊榐偡傞丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @param  aoValue		僶儕傾儞僩崁栚僆僽僕僃僋僩
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							巜掕僼僅儖僟偵摨堦崁栚柤偺崁栚偑搊榐嵪傒偺応崌
     */
    public void addItem (String asPath, String asName, JMVal aoValue) throws
            Exception {

        // 愨懳僷僗柤傪庢摼偡傞
        String sPath = regulatePathName(asPath);
        // 崁栚僆僽僕僃僋僩傪惗惉偡傞
        Item oItem = new Item(asName, aoValue);
        // 崁栚僆僽僕僃僋僩傪 JMFolder 偵搊榐偡傞
        addItemBody(sPath, oItem);

    }

    /**
     * 僇儗儞僩僼僅儖僟偵崁栚柤偲崁栚抣傪巜掕偟偰崁栚僆僽僕僃僋僩傪搊榐偡傞丅
     * @param  asName		崁栚柤
     * @param  aoValue		僶儕傾儞僩崁栚僆僽僕僃僋僩
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							巜掕僼僅儖僟偵摨堦崁栚柤偺崁栚偑搊榐嵪傒偺応崌
     */
    public void addItem (String asName, JMVal aoValue) throws Exception {
        addItem(psCurrentFolder, asName, aoValue);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return byte 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized byte getByteValue (String asPath, String asName) throws
            Exception {

        // 僼僅儖僟僷僗柤偲崁栚柤偵懳墳偡傞僉乕忣曬傪庢摼偡傞
        KeyInfo oKey = getKeyInfo(asPath, asName);

        return (poMap.get(oKey)).getByteValue();

    }

    /**
     * 僇儗儞僩僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return byte 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized byte getByteValue (String asName) throws Exception {
        return getByteValue(psCurrentFolder, asName);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return short 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized short getShortValue (String asPath, String asName) throws
            Exception {

        // 僼僅儖僟僷僗柤偲崁栚柤偵懳墳偡傞僉乕忣曬傪庢摼偡傞
        KeyInfo oKey = getKeyInfo(asPath, asName);

        return (poMap.get(oKey)).getShortValue();

    }

    /**
     * 僇儗儞僩僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return short 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized short getShortValue (String asName) throws
            Exception {
        return getShortValue(psCurrentFolder, asName);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return int 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized int getIntValue (String asPath, String asName) throws
            Exception {

        // 僼僅儖僟僷僗柤偲崁栚柤偵懳墳偡傞僉乕忣曬傪庢摼偡傞
        KeyInfo oKey = getKeyInfo(asPath, asName);

        return (poMap.get(oKey)).getIntValue();

    }

    /**
     * 僇儗儞僩僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return int 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized int getIntValue (String asName) throws Exception {
        return getIntValue(psCurrentFolder, asName);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return long 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized long getLongValue (String asPath, String asName) throws
            Exception {

        // 僼僅儖僟僷僗柤偲崁栚柤偵懳墳偡傞僉乕忣曬傪庢摼偡傞
        KeyInfo oKey = getKeyInfo(asPath, asName);

        return (poMap.get(oKey)).getLongValue();

    }

    /**
     * 僇儗儞僩僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return long 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized long getLongValue (String asName) throws Exception {
        return getLongValue(psCurrentFolder, asName);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return float 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized float getFloatValue (String asPath, String asName) throws
            Exception {

        // 僼僅儖僟僷僗柤偲崁栚柤偵懳墳偡傞僉乕忣曬傪庢摼偡傞
        KeyInfo oKey = getKeyInfo(asPath, asName);

        return (poMap.get(oKey)).getFloatValue();

    }

    /**
     * 僇儗儞僩僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return float 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized float getFloatValue (String asName) throws
            Exception {
        return getFloatValue(psCurrentFolder, asName);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return double 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized double getDoubleValue (String asPath, String asName) throws
            Exception {

        // 僼僅儖僟僷僗柤偲崁栚柤偵懳墳偡傞僉乕忣曬傪庢摼偡傞
        KeyInfo oKey = getKeyInfo(asPath, asName);

        return (poMap.get(oKey)).getDoubleValue();

    }

    /**
     * 僇儗儞僩僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return double 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized double getDoubleValue (String asName) throws
            Exception {
        return getDoubleValue(psCurrentFolder, asName);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return char 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized char getCharValue (String asPath, String asName) throws
            Exception {

        // 僼僅儖僟僷僗柤偲崁栚柤偵懳墳偡傞僉乕忣曬傪庢摼偡傞
        KeyInfo oKey = getKeyInfo(asPath, asName);

        return (poMap.get(oKey)).getCharValue();

    }

    /**
     * 僇儗儞僩僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return char 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized char getCharValue (String asName) throws Exception {
        return getCharValue(psCurrentFolder, asName);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return boolean 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized boolean getBooleanValue (String asPath, String asName) throws