jmfolder.java

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

            Exception {

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

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

    }

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

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

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

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

    }

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

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

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

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

    }

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

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣傪庢摼偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return Date 宆崁栚抣
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized Date getDateValue (String asPath, String asName) throws
            Exception {
        // 僼僅儖僟僷僗柤偲崁栚柤偵懳墳偡傞僉乕忣曬傪庢摼偡傞
        KeyInfo oKey = getKeyInfo(asPath, asName);

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

    }

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

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

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

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

    }

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

    /**
     * 巜掕偝傟偨僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣偑 null 偐偳偆偐
     *僠僃僢僋偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return null 抣偺応崌 true丄偦偆偱側偗傟偽 false
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized boolean isNull (String asPath, String asName) throws
            Exception {

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

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

    }

    /**
     * 僇儗儞僩僼僅儖僟偺奩摉偡傞崁栚柤偺崁栚僆僽僕僃僋僩偺抣偑 null 偐偳偆偐僠
     *僃僢僋偡傞丅<BR>
     * 崁栚僆僽僕僃僋僩偼<tt>JMFolder</tt>偐傜偼嶍彍偝傟側偄丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  asName		崁栚柤
     * @return null 抣偺応崌 true丄偦偆偱側偗傟偽 false
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌<BR>
     *							晄惓側崁栚柤偑巜掕偝傟偨応崌<BR>
     *							奩摉偡傞崁栚偑搊榐偝傟偰偄側偄応崌
     */
    public synchronized boolean isNull (String asName) throws Exception {
        return isNull(psCurrentFolder, asName);
    }

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

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

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

    }

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

    /**
     * 巜掕偝傟偨僼僅儖僟偵奿擺偝傟偰偄傞偡傋偰偺崁栚偺崁栚柤傪庢摼偡傞丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @return 崁栚柤偺攝楍乮崁栚側偟偺応崌丄梫慺悢 0 偺攝楍乯
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌
     */
    public synchronized String[] getItemNames (String asPath) throws
            Exception {

        // 愨懳僷僗柤傪庢摼偡傞
        String sRegulatedPath = regulatePathName(asPath);

        // 奩摉偡傞僼僅儖僟偺慡崁栚傪娷傓僒僽儅僢僾傪庢摼偡傞
        KeyInfo oFrom = new KeyInfo(sRegulatedPath, "");
        KeyInfo oTo = new KeyInfo(oFrom.get1stFolder(),
                                  oFrom.get2ndFolder(),
                                  oFrom.get3rdFolder() + "\0",
                                  "");
        SortedMap oSubMap = poMap.subMap(oFrom, oTo);

        // 僒僽儅僢僾偵娷傑傟傞偡傋偰偺崁栚柤傪庢摼偡傞
        JMVector<String> aItemNames = new JMVector<String>();
        Set oKeyInfos = oSubMap.keySet();
        Iterator iter = oKeyInfos.iterator();
        while (iter.hasNext()) {
            KeyInfo oKey = (KeyInfo) iter.next();
            aItemNames.add(oKey.getItemName());
        }
        return (String[]) aItemNames.toArray(new String[0]);

    }

    /**
     * 僇儗儞僩僼僅儖僟偵奿擺偝傟偰偄傞偡傋偰偺崁栚偺崁栚柤傪庢摼偡傞丅
     * @return 崁栚柤偺攝楍乮崁栚側偟偺応崌丄梫慺悢 0 偺攝楍乯
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌
     */
    public synchronized String[] getItemNames () throws Exception {
        return getItemNames(psCurrentFolder);
    }

    /**
     * 巜掕偝傟偨僼僅儖僟偵奿擺偝傟偰偄傞偡傋偰偺崁栚僆僽僕僃僋僩偺攝楍傪庢摼偡
     * 傞丅<BR>
     * 僒僽僼僅儖僟僼儔僌偑<tt>true</tt>偺応崌丄巜掕僼僅儖僟偲偦偺僒僽僼僅儖僟
     * 傪専嶕懳徾偲偡傞丅
     * @param  asPath		僼僅儖僟僷僗柤
     * @param  abSub			僒僽僼僅儖僟僼儔僌
     * @return 崁栚僆僽僕僃僋僩偺攝楍乮崁栚側偟偺応崌丄梫慺悢 0 偺攝楍乯
     * @throws Exception	晄惓側僼僅儖僟僷僗柤偑巜掕偝傟偨応崌
     */
    public synchronized JMItem[] getItems (String asPath, boolean abSub) throws
            Exception {

        // 愨懳僷僗柤傪庢摼偡傞
        String sRegulatedPath = regulatePathName(asPath);

        // 僒僽儅僢僾偺奐巒僉乕傪庢摼
        SortedMap oSubMap;
        KeyInfo oFrom = new KeyInfo(sRegulatedPath, "");

        // 摿掕偺僼僅儖僟偺捈壓偑巜掕偝傟偨応崌
        if (!abSub) {
            // 摉奩僼僅儖僟偺慡崁栚傪娷傓僒僽儅僢僾傪庢摼偡傞
            KeyInfo oTo = new KeyInfo(oFrom.get1stFolder(),