svn commit: r896431 - in /websites/staging/openwebbeans/trunk/content: ./ owbconfig

[bu...@apache.org]

Author: buildbot
Date: Tue Feb  4 21:11:27 2014
New Revision: 896431

Log:
Staging update by buildbot for openwebbeans

Added:
    websites/staging/openwebbeans/trunk/content/owbconfig
Modified:
    websites/staging/openwebbeans/trunk/content/   (props changed)

Propchange: websites/staging/openwebbeans/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Feb  4 21:11:27 2014
@@ -1 +1 @@
-1564490
+1564496

Added: websites/staging/openwebbeans/trunk/content/owbconfig
==============================================================================
--- websites/staging/openwebbeans/trunk/content/owbconfig (added)
+++ websites/staging/openwebbeans/trunk/content/owbconfig Tue Feb  4 21:11:27 2014
@@ -0,0 +1,100 @@
+Title: OpenWebBeans FAQ 
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you 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.
+
+# OpenWebBeans and JavaSE
+
+To add OpenWebBeans to your javaSE project you need to take the following steps:
+
+ 1. Add required jars to your project
+ 2. Bootstrap OpenWebBeans
+ 3. Done! Congratulations.
+
+
+###Adding required jars to your project
+
+You can add OpenWebBeans to your project manually by adding jars or with Apache Maven. 
+How to download is explained here: [download page][1].
+
+
+For JavaSE you need:
+
+  - **openwebbeans-spi.jar**
+  - **openwebbeans-impl.jar**
+
+Those two parts of OpenWebBeans are what you could call "system core".
+These are the only OWB artifacts you need for JavaSE capabilities and 
+for the time being the existing plugins basically just adds JavaEE capabilities. 
+
+
+You also need to add some spec API jars for the CDI, atinject and interceptors 
+specifications.
+
+  - **geronimo-jcdi_1.0_spec.jar**
+  - **geronimo-atinject_1.0_spec.jar**
+  - **geronimo-interceptor_1.1_spec.jar**
+
+ 
+After you have added the jars described above to your project accordingly 
+to the download page and added them to your projects classpath.
+
+###Bootstrapping OpenWebBeans
+
+For now we recommend two ways for booting up the OpenWebBeans container: 
+[**Deltaspike CdiCtrl**][2] or booting it yourself in i.e. a standard main method. 
+
+#### Option number one - Apache DeltaSpike CdiCtrl
+
+Apache DeltaSpike is a set of portable CDI Extensions. It contains a module which allows
+to control various CDI-Containers without having to change your own code. It contains an API
+and multiple implementations for a few CDI Containers.
+
+For most projects [**Deltaspike CdiCtrl**][2] will be the smoother choice to boot your project
+in JavaSE . 
+
+
+#### Option number two - booting yourself**
+
+Going native and booting Apache OpenWebBeans yourself could however be useful if you need full control 
+to do advanced things. 
+
+    :::java
+    import org.apache.deltaspike.cdise.api.CdiContainer;
+    import org.apache.deltaspike.cdise.api.CdiContainerLoader;
+    import org.apache.deltaspike.cdise.api.ContextControl;
+    import javax.enterprise.context.ApplicationScoped;
+
+    public class MainApp {
+        private static ContainerLifecycle lifecycle = null;
+        public static void main(String[] args) {
+            lifecycle = WebBeansContext.currentInstance().getService(ContainerLifecycle.class);
+            lifecycle.startApplication(null);
+        }
+
+        public static void shutdown() {
+            lifecycle.stopApplication(null);
+        }
+    }
+
+
+
+From here you might want to look at our samples selection: [samples][3].
+
+
+  [1]: /openwebbeans/download.html
+  [2]: http://deltaspike.apache.org/documentation.html#with-java-se
+  [3]: /openwebbeans/samples.html
\ No newline at end of file