TypeScript IItemsHoldr.IItemsHoldr類代碼示例

    /**
     * Ensures a collection exists by checking for it and creating it under
     * the internal ItemsHoldr if it doesn't.
     * 
     * @param collectionKey   The key for the collection that must exist,
     *                        including the prefix.
     */
    private ensureCollectionKeyExists(collectionKey: string): void {
        if (!this.ItemsHolder.hasKey(collectionKey)) {
            this.ItemsHolder.addItem(collectionKey, {
                "valueDefault": {},
                "storeLocally": true
            });

            this.collectionKeys.push(collectionKey);
            this.ItemsHolder.setItem(this.prefix + "collectionKeys", this.collectionKeys);
        }
    }

    /**
     * Sets the currently tracked collection.
     * 
     * @param collectionKeyRawNew   The raw key of the new collection
     *                              to switch to.
     * @param value   An optional container of values to set the new
     *                collection equal to.
     */
    public setCollection(collectionKeyRawNew: string, value?: any): void {
        this.collectionKeyRaw = collectionKeyRawNew;
        this.collectionKey = this.prefix + this.collectionKeyRaw;

        this.ensureCollectionKeyExists(this.collectionKey);

        if (value) {
            this.ItemsHolder.setItem(this.collectionKey, value);
        }

        this.collection = this.ItemsHolder.getItem(this.collectionKey);
    }

    /**
     * Adds a change to any collection requested by the key, stored as a key-value
     * pair under an item.
     * 
     * @param collectionKeyOtherRaw   The raw key for the other collection
     *                                to add the change under.
     * @param itemKey   The key for the item experiencing the change.
     * @param valueKey   The attribute of the item being changed.
     * @param value   The actual value being stored.
     */
    public addCollectionChange(collectionKeyOtherRaw: string, itemKey: string, valueKey: string, value: any): void {
        const collectionKeyOther: string = this.prefix + collectionKeyOtherRaw;

        this.ensureCollectionKeyExists(collectionKeyOther);
        const otherCollection: any = this.ItemsHolder.getItem(collectionKeyOther);

        if (typeof otherCollection[itemKey] === "undefined") {
            otherCollection[itemKey] = {};
        }

        otherCollection[itemKey][valueKey] = value;

        this.ItemsHolder.setItem(collectionKeyOther, otherCollection);
    }

    /**
     * @param otherCollectionKeyRaw   A key for a collection to retrieve.
     * @returns The collection stored under the raw key, if it exists.
     */
    public getOtherCollection(otherCollectionKeyRaw: string): void {
        const otherCollectionKey: string = this.prefix + otherCollectionKeyRaw;

        this.ensureCollectionKeyExists(otherCollectionKey);

        return this.ItemsHolder.getItem(otherCollectionKey);
    }

 /**
  * Saves the currently tracked collection into the ItemsHolder.
  */
 public saveCollection(): void {
     this.ItemsHolder.setItem(this.collectionKey, this.collection);
     this.ItemsHolder.setItem(this.prefix + "collectionKeys", this.collectionKeys);
 }