001    /**
002     *
003     * Copyright 2006 The Apache Software Foundation
004     *
005     *  Licensed under the Apache License, Version 2.0 (the "License");
006     *  you may not use this file except in compliance with the License.
007     *  You may obtain a copy of the License at
008     *
009     *     http://www.apache.org/licenses/LICENSE-2.0
010     *
011     *  Unless required by applicable law or agreed to in writing, software
012     *  distributed under the License is distributed on an "AS IS" BASIS,
013     *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014     *  See the License for the specific language governing permissions and
015     *  limitations under the License.
016     */
017    
018    package javax.mail;
019    
020    
021    /**
022     * An interface for Store implementations to support the IMAP RFC 2087 Quota extension.
023     *
024     * @version $Rev: 421852 $ $Date: 2006-07-14 03:02:19 -0700 (Fri, 14 Jul 2006) $
025     */
026    
027    public interface QuotaAwareStore {
028        /**
029         * Get the quotas for the specified root element.
030         *
031         * @param root   The root name for the quota information.
032         *
033         * @return An array of Quota objects defined for the root.
034         */
035        public Quota[] getQuota(String root);
036    
037        /**
038         * Set a quota item.  The root contained in the Quota item identies
039         * the quota target.
040         *
041         * @param quota  The source quota item.
042         */
043        public void setQuota(Quota quota);
044    }
045    
046