com.echopf.contents.ECHOContentsCategoriesMap.java Source code

Introduction

Here is the source code for com.echopf.contents.ECHOContentsCategoriesMap.java

Source

/*******
 Copyright 2015 NeuroBASE,Inc. All Rights Reserved.
     
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at
     
 http://www.apache.org/licenses/LICENSE-2.0
     
 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 **********/

package com.echopf.contents;

import com.echopf.*;

import java.util.ArrayList;
import java.util.List;

import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;

/**
 * {@.en An ECHOContentsCategoriesMap expresses a hierarchical category map.}
 * {@.ja ???{@link com.echopf.contents.ECHOContentsCategoryObject}??}
 */
public class ECHOContentsCategoriesMap extends ECHOTreeMap<ECHOContentsCategoryObject, ECHOContentsCategoriesMap>
        implements Fetchable<ECHOContentsCategoriesMap> {

    /* Begin constructors */

    /**
     * {@.en Constructs a new ECHOContentsCategoriesMap based on an existing *entire* one on the remote server.}
     * {@.ja ?????????????}
     * 
     * @param instanceId
     *       {@.en the reference ID of the instance to which the category map has belonged}
     *       {@.ja ???ID}
     */
    public ECHOContentsCategoriesMap(String instanceId) {
        super(instanceId, "categories");
    }

    /**
     * {@.en Constructs a new ECHOContentsCategoriesMap based on an existing *sub* one on the remote server.}
     * {@.ja ???????????}
     * 
     * @param instanceId
     *       {@.en the reference ID of the instance to which the category map has belonged}
     *       {@.ja ???ID}
     * @param refid
     *       {@.en the reference ID of the root node of the existing sub one}
     *       {@.ja ????ID}
     */
    public ECHOContentsCategoriesMap(String instanceId, String refid) {
        super(instanceId, "categories", refid);
    }

    /**
     * Constructs a new ECHOContentsCategoriesMap linking a ECHOContentsCategoryObject.
     *   based on an existing *entire* one on the remote server.
     *   
     * @param instanceId the reference ID of the instance to which the category map has belonged
     * @param source a source JSONObject to copy
     */
    public ECHOContentsCategoriesMap(String instanceId, JSONObject source) {
        super(instanceId, "categories", source);
    }

    /**
     * Constructs a new ECHOContentsCategoriesMap linking a ECHOContentsCategoryObject
     *   based on an existing *sub* one on the remote server.
     *
     * @param instanceId : the reference ID of the instance to which the category map has belonged
     * @param refid the reference ID of the root node of the existing sub one
     * @param source a source JSONObject to copy
     */
    public ECHOContentsCategoriesMap(String instanceId, String refid, JSONObject source) {
        super(instanceId, "categories", refid, source);
    }

    /* End constructors */

    /*
     * Implement a Fetchable
     * @see com.echopf.Fetchable#fetch()
     */
    public ECHOContentsCategoriesMap fetch() throws ECHOException {
        doFetch(true, null);
        return this;
    }

    /*
     * Implement a Fetchable
     * @see com.echopf.Fetchable#fetchInBackground()
     */
    public void fetchInBackground(FetchCallback<ECHOContentsCategoriesMap> callback) {
        try {
            doFetch(false, callback);
        } catch (ECHOException e) {
            throw new InternalError();
        }
    }

    /**
     * Copies data from a JSONObject.
     */
    @Override
    protected void copyData(JSONObject source) {
        if (source == null)
            throw new IllegalArgumentException("Argument `source` must not be null.");

        JSONArray categories = source.optJSONArray("categories");
        if (categories != null) {

            if (is_subtree) {
                JSONObject obj = categories.optJSONObject(0);
                if (obj == null)
                    return; // skip

                JSONArray jsonChildren = obj.optJSONArray("children");

                String refid = obj.optString("refid");
                if (refid.isEmpty())
                    return; // skip

                this.node = new ECHOContentsCategoryObject(instanceId, refid, obj);
                this.children = children(jsonChildren);
            } else {
                this.children = children(categories);
            }

        }
    }

    /**
     * Builds children recursively.
     */
    private List<ECHOContentsCategoriesMap> children(JSONArray source) {
        List<ECHOContentsCategoriesMap> children = new ArrayList<ECHOContentsCategoriesMap>();

        if (source == null || source.length() == 0)
            return children;

        for (int i = 0; i < source.length(); i++) {
            JSONObject obj = source.optJSONObject(i);
            if (obj == null)
                continue; // skip

            String refid = obj.optString("refid");
            if (refid.isEmpty())
                continue; // skip

            try {
                ECHOContentsCategoriesMap map = new ECHOContentsCategoriesMap(instanceId, refid,
                        new JSONObject("{\"categories\":[" + obj.toString() + "]}"));
                children.add(map);
            } catch (JSONException ignored) {
                // skip
            }
        }

        return children;
    }
}