You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@deltaspike.apache.org by cm...@apache.org on 2012/09/13 17:51:59 UTC
svn commit: r1384384 - in
/incubator/deltaspike/site/trunk/content/deltaspike: community.mdtext
documentation.mdtext resources/css/bootstrap.css source.mdtext
Author: cmoulliard
Date: Thu Sep 13 15:51:58 2012
New Revision: 1384384
URL: http://svn.apache.org/viewvc?rev=1384384&view=rev
Log:
Modify source page
Modified:
incubator/deltaspike/site/trunk/content/deltaspike/community.mdtext
incubator/deltaspike/site/trunk/content/deltaspike/documentation.mdtext
incubator/deltaspike/site/trunk/content/deltaspike/resources/css/bootstrap.css
incubator/deltaspike/site/trunk/content/deltaspike/source.mdtext
Modified: incubator/deltaspike/site/trunk/content/deltaspike/community.mdtext
URL: http://svn.apache.org/viewvc/incubator/deltaspike/site/trunk/content/deltaspike/community.mdtext?rev=1384384&r1=1384383&r2=1384384&view=diff
==============================================================================
--- incubator/deltaspike/site/trunk/content/deltaspike/community.mdtext (original)
+++ incubator/deltaspike/site/trunk/content/deltaspike/community.mdtext Thu Sep 13 15:51:58 2012
@@ -27,14 +27,12 @@ Before you file a ticket in our [Jira](h
You are very welcome to follow our twitter account [@DeltaSpikeTeam](http://twitter.com/#!/DeltaSpikeTeam) and spread the word of DeltaSpike with Tweets, Blog-Entries,...
-
# Contributors
Before you get a committer you have to contribute to our effort. E.g. you can help users, participate in discussions on the dev list, submit patches,... . Therefore, it's essential to file a/n [(I)CLA](http://www.apache.org/licenses/icla.txt) or [CLA](http://www.apache.org/licenses/cla-corporate.txt) and send it to secretary at apache dot org (or fax it) as early as possible.
If you would like to submit a patch through Jira, you can have a look at the [suggested approach](suggested-git-workflows.html)
-
# Committers
Before you read this section, please ensure that you have read the contributor section. All of you are welcome to join our development effort. [Subscribe](mailto:deltaspike-dev-subscribe@incubator.apache.org) our [mailing list for developers](mailto:deltaspike-dev@incubator.apache.org) and start contributing and help users.
@@ -47,9 +45,7 @@ Further details are available at [http:/
Procedure to become a new [committer](new-commiter)
-
# Mailing lists
-
<table class="table">
<thead>
@@ -97,13 +93,11 @@ Procedure to become a new [committer](ne
* Mail Archived : [mail-archive](http://mail-archives.apache.org/mod_mbox/incubator-deltaspike-users/)
* Mirrors are available at: [MarkMail](http://markmail.org/search/?q=list%3Aorg.apache.incubator.deltaspike-users+order%3Adate-backward)
-
-# Twitter, IRC
+# Twitter - IRC
* Twitter : [@DeltaSpikeTeam](http://twitter.com/#!/DeltaSpikeTeam)
* IRC : Server irc.freenode.net and channel #deltaspike
-
# JIRA
* Web Site : [Jira](https://issues.apache.org/jira/browse/DELTASPIKE
\ No newline at end of file
Modified: incubator/deltaspike/site/trunk/content/deltaspike/documentation.mdtext
URL: http://svn.apache.org/viewvc/incubator/deltaspike/site/trunk/content/deltaspike/documentation.mdtext?rev=1384384&r1=1384383&r2=1384384&view=diff
==============================================================================
--- incubator/deltaspike/site/trunk/content/deltaspike/documentation.mdtext (original)
+++ incubator/deltaspike/site/trunk/content/deltaspike/documentation.mdtext Thu Sep 13 15:51:58 2012
@@ -22,63 +22,51 @@ Notice: Licensed to the Apache Softwa
# Get your shoes with DeltaSpike
-As [CDI]() implmentations are not provided out of the box top of all Java Containers (Java SE, Web Application Server - Apache Tomcat, Eclipse Jetty, ...), this is where DeltaSpike will help
-you as it provides the tooling required to bootstrap the container. One of the key benefit is that it offers you the possibility to start with the CDI implementation
-of your choice ([JBoss Weld](), [Apache OpenWebbeans](), [Apache OpenEJB]()) as it uses the ServiceLoader of JDK to detect which implementation has been packaged in your
-project's classpath.
+As a [CDI](http://jcp.org/en/jsr/detail?id=299) container is not provided out of the box top of all Java runtime (Java-SE, Web Application Server - Apache Tomcat, Eclipse Jetty, ...),
+DeltaSpike will help you as it provides the tooling required to bootstrap a standalone container. Moreover it offers you the possibility to start with the CDI implementation
+of your choice ([JBoss Weld](http://docs.jboss.org/weld/reference/1.1.5.Final/en-US/html/), [Apache OpenWebbeans](http://openwebbeans.apache.org), [Apache OpenEJB](http://openejb.apache.org))
+as it uses the ServiceLoader of JDK to detect which implementation has been packaged in your project's classpath.
+
+To bootstrap a CDI container in your Java application, you just need to instantiate the CdiContainer and call the boot method.
+
+ import org.apache.deltaspike.cdise.api.CdiContainer;
+ import org.apache.deltaspike.cdise.api.CdiContainerLoader;
+ ....
-To
+ public class SimpleApp {
+ public static void main(String[] args) {
-Required modules:
+ CdiContainer CdiContainer = CdiContainerLoader.getCdiContainer();
+ CdiContainer.boot();
- * Core
+ // You can use CDI here
-**Hint**
+ CdiContainer.shutdown();
+ }
+ }
-In the listings below replace the placeholders for the version with the version of your choice or use:
+When boot is called, the CdiContainer will scan the whole classpath for Beans and CDI extensions available.
- <properties>
- <deltaspike.version>0.3-incubating</deltaspike.version>
- </properties>
+Note: booting the container does <i>not</i> automatically start all CDI Contexts! Depending on the underlying CDI container you might need to invoke `getContextControl()
+and execute ContextControl#startContext(Class)` or `ContextControl#startContexts()`.
+To inject a bean in this project, you should use the `BeanManagerProvider` or the `BeanProvider` like this
-## With Java-EE6+
-If you are using DeltaSpike in a Java-EE6 environment, you don't need to configure a CDI implementation explicitly because it's shipped with the container.
+ EchoService defaultEchoService = BeanProvider.getContextualReference(DefaultEchoService.class, false);
-## Without Java-EE6+
-Java-EE5 application servers as well as pure servlet containers like Apache Tomcat don't provide a CDI implementation out-of-the-box. So don't forget to setup the CDI implementation of your choice.
+When you have finish the job, simply call `shutdown()` to tell to the CDI container to destroy the beans instantiated
-## With Java-SE
+Remarks :
-Several DeltaSpike features can be used with Java-SE5+ only. Therefore, you have to bootstrap the CDI container of your choise manually.
+- Java-EE5 : Java-EE5 application servers as well as pure servlet containers like Apache Tomcat don't provide a CDI implementation out-of-the-box. So don't forget to setup the CDI implementation of your choice.
+- Java-EE6+ : If you are using DeltaSpike in a Java-EE6 environment, you don't need to configure a CDI implementation explicitly because it's shipped with the container.
- public class SimpleApp {
- public static void main(String[] args) {
- CdiContainer.start();
+# A more complex case
- //You can use CDI here - since you can't inject a bean in this class directly use the BeanManagerProvider or the BeanProvider
+TBD
- CdiContainer.stop();
- }
- }
-
- /**
- * Helper class to start and stop the OpenWebBeansContainer
- */
- public class CdiContainer {
- private static ContainerLifecycle lifecycle = null;
-
- public static void start() {
- lifecycle = WebBeansContext.currentInstance().getService(ContainerLifecycle.class);
- lifecycle.startApplication(null);
- }
-
- public static void stop() {
- lifecycle.stopApplication(null);
- }
- }
-
-# Features
+# Project's features
Another characteristic of DeltaSpike is that it provides [CDI extension]() to cover new features which are not proposed by the CDI 1.0 specification.
-Such features
+
+TBD
Modified: incubator/deltaspike/site/trunk/content/deltaspike/resources/css/bootstrap.css
URL: http://svn.apache.org/viewvc/incubator/deltaspike/site/trunk/content/deltaspike/resources/css/bootstrap.css?rev=1384384&r1=1384383&r2=1384384&view=diff
==============================================================================
--- incubator/deltaspike/site/trunk/content/deltaspike/resources/css/bootstrap.css (original)
+++ incubator/deltaspike/site/trunk/content/deltaspike/resources/css/bootstrap.css Thu Sep 13 15:51:58 2012
@@ -465,7 +465,8 @@ h6 small {
h1 {
font-size: 30px;
- line-height: 36px;
+ /* line-height: 36px; */
+ line-height: 56px;
}
h1 small {
@@ -474,7 +475,8 @@ h1 small {
h2 {
font-size: 24px;
- line-height: 36px;
+ /* line-height: 36px; */
+ line-height: 48px;
}
h2 small {
Modified: incubator/deltaspike/site/trunk/content/deltaspike/source.mdtext
URL: http://svn.apache.org/viewvc/incubator/deltaspike/site/trunk/content/deltaspike/source.mdtext?rev=1384384&r1=1384383&r2=1384384&view=diff
==============================================================================
--- incubator/deltaspike/site/trunk/content/deltaspike/source.mdtext (original)
+++ incubator/deltaspike/site/trunk/content/deltaspike/source.mdtext Thu Sep 13 15:51:58 2012
@@ -34,10 +34,8 @@ Remarks :
- We follow an unified [GIT workflow](suggested-git-workflows.html) to keep the commit history straight and therefore simple and clean.
General details about GIT at Apache are available [here](http://wiki.apache.org/couchdb/Git_At_Apache_Guide) and at [http://git-wip-us.apache.org](http://git-wip-us.apache.org).
-
# How to checkout the code
-
## Anonymous users
Users can download the code source from GitHub repository or Apache Git using the following urls and git clone instruction.
@@ -51,29 +49,24 @@ More information about URL to be used ca
// GitHub
git clone https://github.com/apache/incubator-deltaspike.git
-
## Members
The members of DeltaSpike project which are also committers and contributers will use a different URL address
git clone https://git-wip-us.apache.org/repos/asf/incubator-deltaspike.git
-
# Build
So now you probably want to **`build the code`**. So follow here the [instructions](build.html)
-
# Formatting code
Users/committers when providing code (patches, ...) should adopt "formatting rules" which are provided hereafter for IntelliJ and Eclipse
-
## IntelliJ
[Attached](resources/files/settings.jar) you can find the settings for formatting the source code. Import them via File | Import Settings...
-
## Eclipse
-For Eclipse you can use this [Code Formatter Profile](resources/files/deltaspike-code-conventions.xml). Import it via Window | Preferences | Java | Code Style | Formatter
+For Eclipse you can use this [Code Formatter Profile](resources/files/deltaspike-code-conventions.xml). Import it via Window | Preferences | Java | Code Style | Formatter
\ No newline at end of file