<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" 
                          "http://forrest.apache.org/dtd/document-v20.dtd">
<document>
  <header>
    <title>FAQ</title>
  </header>
<body>
  <section>
    <title>General</title>
    <section id="what-is">
        <title>What is Beehive?</title>
        <p>
        Beehive is a programming model atop J2EE that simplifies building enterprise applications. See the <a href="index.html">overview</a> for more info.
        </p>
    </section>
    <section id="annotations">
        <title>What are annotations or Java 5 metadata?</title>
        <p>
        Annotations, also known as Java 5 metadata, are a new Java language feature introduced in JDK 5.  They allow metadata to be added to Java source 
        files that exists outside of ordinary programmatic flow control.  In Beehive, annotations are used for setting properties on source files that 
        are then processed at both build time and runtime.  For more information on annotations in Java see 
        <a class="fork" href="http://jcp.org/en/jsr/detail?id=175">JSR 175</a>
        </p>
    </section>
    <section id="controls">
        <title>What are Controls?</title>
        <p>
        Controls are Beehive's new component model. They are based on standard JavaBeans and provide an enhanced authoring and extensibility models
        using Java 5 metadata.  For more information on Controls, see the 
        <a href="http://beehive.apache.org/docs/1.0/controls/overview.html">Controls Overview</a>.
        </p>
    </section>  
    <section id="controlhaus">
        <title>What happened to ControlHaus?</title>
        <p>
        ControlHaus (http://www.controlhaus.org) was a website that hosted several Beehive controls including those for resource
        access (JDBC, JMS, EJB, and Web Service), Google, Hibernate, and several others.  The Beehive committers found it difficult
        to manage development of Beehive across two communities (Apache and ControlHaus) and made the decision in the Spring of 2005
        to merge the resource access controls (JDBC, JMS, EJB, and Web Service) into the Apache community.  The other controls were 
        removed.  We would welcome any control contributions which could be made to either Apache Beehive or to a Beehive "modules" 
        project hosted externally.
        </p>
    </section>
    <section>
        <title>Does Beehive Support Commons Attributes?</title>
        <p>
        Since Beehive uses JDK5, which already supports JSR 175 annotations, support for commons-attributes is not a goal for Beehive.
        </p>
    </section>
  </section>
</body>
<footer>
  <legal>&copy; 2004-2005, Apache Software Foundation</legal>
</footer>
</document>
