name.java

google gdata API 很好用的API

/* Copyright (c) 2006 Google Inc.
 *
 * 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.google.gdata.data.extensions;

import com.google.gdata.util.common.xml.XmlWriter;
import com.google.gdata.data.Extension;
import com.google.gdata.data.ExtensionDescription;
import com.google.gdata.data.ExtensionPoint;
import com.google.gdata.data.ExtensionProfile;
import com.google.gdata.util.Namespaces;
import com.google.gdata.util.ParseException;
import com.google.gdata.util.XmlParser.ElementHandler;

import org.xml.sax.Attributes;

import java.io.IOException;
import java.util.ArrayList;

/**
 * G name space element: <gd:login>.  Used to model a user account.
 * Has attribute "userName" and "passwordHash".
 *
 * 
 *
 */

public class Name extends ExtensionPoint implements Extension {
  public static final String EXTENSION_LOCAL_NAME = "name";
  public static final String ATTRIBUTE_FAMILY_NAME = "familyName";
  public static final String ATTRIBUTE_GIVEN_NAME = "givenName";

  // property "familyName"
  protected String familyName;
  public String getFamilyName() {
    return this.familyName;
  }
  public void setFamilyName(String familyName) {
    this.familyName = familyName;
  }

  // property "givenName"
  protected String givenName;
  public String getGivenName() {
    return this.givenName;
  }
  public void setGivenName(String givenName) {
    this.givenName = givenName;
  }

  /**
   * @return Description of this extension
   */
  public static ExtensionDescription getDefaultDescription() {
    ExtensionDescription description = new ExtensionDescription();
    description.setExtensionClass(Name.class);
    description.setNamespace(Namespaces.gNs);
    description.setLocalName(EXTENSION_LOCAL_NAME);
    description.setRepeatable(false);
    return description;
  }

  public void generate(XmlWriter w, ExtensionProfile extensionProfile)
      throws IOException {
    ArrayList<XmlWriter.Attribute> attributes =
      new ArrayList<XmlWriter.Attribute>();

    if (this.familyName != null) {
      attributes.add(
        new XmlWriter.Attribute(ATTRIBUTE_FAMILY_NAME, this.familyName)
      );
    }

    if (this.givenName != null) {
      attributes.add(
        new XmlWriter.Attribute(ATTRIBUTE_GIVEN_NAME, this.givenName)
      );
    }

    generateStartElement(
      w, Namespaces.gNs, EXTENSION_LOCAL_NAME, attributes, null
    );

    // Invoke ExtensionPoint.
    generateExtensions(w, extensionProfile);

    w.endElement(Namespaces.gNs, EXTENSION_LOCAL_NAME);
  }

  public ElementHandler getHandler(
      ExtensionProfile extProfile, String namespace,
      String localName, Attributes attrs)
      throws ParseException, IOException {
    return new Handler(extProfile);
  }

  /** <g:name> parser. */
  private class Handler extends ExtensionPoint.ExtensionHandler {
    public Handler(ExtensionProfile extProfile)
        throws ParseException, IOException {
      super(extProfile, Email.class);
    }

    public void processAttribute(
        String namespace, String localName, String value)
        throws ParseException {
      if ("".equals(namespace)) {
        if (ATTRIBUTE_FAMILY_NAME.equals(localName)) {
          familyName = value;
        } else if (ATTRIBUTE_GIVEN_NAME.equals(localName)) {
          givenName = value;
        }
      }
    }

    public void processEndElement() throws ParseException {
      if (familyName == null) {
        throw new ParseException(
          Namespaces.gNs + ":" + EXTENSION_LOCAL_NAME
          + "/@" + ATTRIBUTE_FAMILY_NAME + " is required."
        );
      }

      if (givenName == null) {
        throw new ParseException(
          Namespaces.gNs + ":" + EXTENSION_LOCAL_NAME
          + "/@" + ATTRIBUTE_GIVEN_NAME + " is required."
        );
      }

      super.processEndElement();
    }
  }
}