Copyright Microsoft Corporation
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.
/**
 * Copyright Microsoft Corporation
 * 
 * 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.microsoft.azure.storage;

import java.util.EnumSet;

import com.microsoft.azure.storage.core.SR;

Specifies the set of possible services for a shared access account policy.
/**
 * Specifies the set of possible services for a shared access account policy.
 */
public enum SharedAccessAccountService {
    
Permission to access blob resources granted.
/**
     * Permission to access blob resources granted.
     */
    BLOB('b'),

    
Permission to access file resources granted.
/**
     * Permission to access file resources granted.
     */
    FILE('f'),

    
Permission to access queue resources granted.
/**
     * Permission to access queue resources granted.
     */
    QUEUE('q'),

    
Permission to access table resources granted.
/**
     * Permission to access table resources granted.
     */
    TABLE('t');
    
    char value;

    
Create a SharedAccessAccountService.
Params:
c – 
           The char which represents this service./**
     * Create a <code>SharedAccessAccountService</code>.
     * 
     * @param c
     *            The <code>char</code> which represents this service.
     */
    private SharedAccessAccountService(char c) {
        this.value = c;
    }
    
    
Converts the given services to a String.
Params:
services – 
           The services to convert to a String.
Returns:
A String which represents the SharedAccessAccountServices./**
     * Converts the given services to a <code>String</code>.
     * 
     * @param services
     *            The services to convert to a <code>String</code>.
     *            
     * @return A <code>String</code> which represents the <code>SharedAccessAccountServices</code>.
     */
    static String servicesToString(EnumSet<SharedAccessAccountService> services) {
        if (services == null) {
            return Constants.EMPTY_STRING;
        }
        
        StringBuilder value = new StringBuilder();
        
        for (SharedAccessAccountService service : services) {
            value.append(service.value);
        }
        
        return value.toString();
    }
    
    
Creates an EnumSet<SharedAccessAccountService> from the specified services string. 
Params:
servicesString – 
           A String which represents the SharedAccessAccountServices.
Returns:
A EnumSet<SharedAccessAccountService> generated from the given String./**
     * Creates an {@link EnumSet<SharedAccessAccountService>} from the specified services string.
     * 
     * @param servicesString
     *            A <code>String</code> which represents the <code>SharedAccessAccountServices</code>.
     * @return A {@link EnumSet<SharedAccessAccountService>} generated from the given <code>String</code>.
     */
    static EnumSet<SharedAccessAccountService> servicesFromString(String servicesString) {
        EnumSet<SharedAccessAccountService> resources = EnumSet.noneOf(SharedAccessAccountService.class);

        for (final char c : servicesString.toLowerCase().toCharArray()) {
            boolean invalidCharacter = true;
            
            for (SharedAccessAccountService service : SharedAccessAccountService.values()) {
                if (c == service.value) {
                    resources.add(service);
                    invalidCharacter = false;
                    break;
                }
            }
            
            if (invalidCharacter) {
                throw new IllegalArgumentException(
                        String.format(SR.ENUM_COULD_NOT_BE_PARSED, "Services", servicesString));
            }
        }
        
        return resources;
    }
}