Return-Path: X-Original-To: apmail-deltaspike-commits-archive@www.apache.org Delivered-To: apmail-deltaspike-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 3D950108A0 for ; Mon, 15 Dec 2014 22:31:44 +0000 (UTC) Received: (qmail 67542 invoked by uid 500); 15 Dec 2014 22:31:44 -0000 Delivered-To: apmail-deltaspike-commits-archive@deltaspike.apache.org Received: (qmail 67443 invoked by uid 500); 15 Dec 2014 22:31:44 -0000 Mailing-List: contact commits-help@deltaspike.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@deltaspike.apache.org Delivered-To: mailing list commits@deltaspike.apache.org Received: (qmail 67117 invoked by uid 99); 15 Dec 2014 22:31:44 -0000 Received: from eris.apache.org (HELO hades.apache.org) (140.211.11.105) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 15 Dec 2014 22:31:43 +0000 Received: from hades.apache.org (localhost [127.0.0.1]) by hades.apache.org (ASF Mail Server at hades.apache.org) with ESMTP id CBE83AC10EE for ; Mon, 15 Dec 2014 22:31:43 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r932889 [6/7] - in /websites/staging/deltaspike/trunk/content: ./ documentation/ Date: Mon, 15 Dec 2014 22:31:43 -0000 To: commits@deltaspike.apache.org From: buildbot@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20141215223143.CBE83AC10EE@hades.apache.org> Added: websites/staging/deltaspike/trunk/content/documentation/modules.html ============================================================================== --- websites/staging/deltaspike/trunk/content/documentation/modules.html (added) +++ websites/staging/deltaspike/trunk/content/documentation/modules.html Mon Dec 15 22:31:42 2014 @@ -0,0 +1,277 @@ + + + + + + + + +Overview of DeltaSpike Modules + + + + + + + + + + + + + + + + +
+
+
+
+

Overview of DeltaSpike Modules

+
+ +
+ +
+ +
+

DeltaSpike consists of ready-to-use modules. These include a core module and a number of optional modules for providing additional enterprise functionality to your applications. An overview of each module is provided here and for more information see the linked individual module pages.

+
+ + +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1. DeltaSpike Modules

Core

Required

+

For fundamental and defining DeltaSpike API and utility classes

+

Bean Validation

Optional

+

For adding CDI support in Bean Validation, enabling creation of CDI aware ConstraintValidator methods that can use business objects (EJBs, ManagedBeans) to support validation needs

+

Container Control

Optional

+

For CDI container booting and shutdown and associated context lifecycle management

+

Data

Optional

+

For an enhanced JPA experience with declarative queries, reducing boilerplate to a minimum

+

JPA

Optional

+

For transactional context and scope

+

JSF

Optional

+

For CDI integration with JSF, with type-safe view config, multi-window handling, new scopes (WindowScoped, ViewScope, ViewAccessScoped, GroupedConversationScoped) and integration with DeltaSpike “core” messages and exception handling

+

Partial-Bean

Optional

+

For implementing a generic handler to replace manual implementations of interfaces (or abstract classes)

+

Scheduler

Optional

+

For simple integration with Quartz v2 (default) or any other scheduler that supports cron-expressions for job-classes

+

Security

Optional

+

For intercept and security checking on method calls

+

Servlet

Optional

+

For integration with the Java Servlet API, enabling injection of common servlet objects and propagation of servlet events to the CDI event bus

+

Test-Control

Optional

+

For writing CDI-based tests easily

+
+
+ +
+ +
+

Copyright © 2011-2014 The Apache Software Foundation, Licensed under the Apache License, Version 2.0.

+

Apache and the Apache feather logo are trademarks of The Apache Software Foundation.

+
+ +
+ + + + \ No newline at end of file Added: websites/staging/deltaspike/trunk/content/documentation/overview.html ============================================================================== --- websites/staging/deltaspike/trunk/content/documentation/overview.html (added) +++ websites/staging/deltaspike/trunk/content/documentation/overview.html Mon Dec 15 22:31:42 2014 @@ -0,0 +1,363 @@ + + + + + + + + +Overview of DeltaSpike + + + + + + + + + + + + + + + + +
+
+
+
+

Overview of DeltaSpike

+
+ +
+ +
+ +
+

Background

+
+
+

CDI

+
+

Java Contexts and Dependency Injection for the Java EE platform (JSR 299), abbreviated to CDI, was introduced as part of Java EE6. The core features of CDI are as follows:

+
+
+
    +
  • +

    improved stateful object lifecycles with an additional context named Conversation that encompasses a series of requests within one session and lifecycle management by the container according to well-defined contexts

    +
  • +
  • +

    dependency injection conducted in a type-safe manner, with type checking conducted at compilation time so errors are exposed earlier and debugging is easier

    +
  • +
  • +

    event notification facility for object interaction

    +
  • +
  • +

    a better approach for interceptors with annotations binding interceptors to objects and with a new interceptor named decorator that knows about individual bean attributes through inheritence and is more appropriate for use in solving business problems

    +
  • +
  • +

    a Service Provider Interface (SPI) for developing portable extensions to the CDI container

    +
  • +
+
+
+

CDI is a Java Community Process (JCP) standard. All Java EE6 compliant application servers must provide support for CDI. JBoss Weld is a reference implementation of the CDI specification and other spec-compliant implementations exist such as Apache OpenWebBeans (OWB). While CDI is a Java EE6 essential, CDI can also be used in Java SE environments with the aid of standalone CDI implementations.

+
+
+
+

Portable CDI Extensions

+
+

The CDI Service Provider Interface (SPI) is exposed to enable extension of the CDI feature set by third-parties. Portable CDI extensions extend CDI implementations and improve existing Java EE APIs by enabling integration of different technologies.

+
+
+

As set out in the CDI specification, a portable CDI extenstion may integrate with a CDI container as follows:

+
+
+
    +
  • +

    providing its own beans, interceptors and decorators to the container

    +
  • +
  • +

    injecting dependencies into its own objects using the dependency injection service

    +
  • +
  • +

    providing a context implementation for a custom scope

    +
  • +
  • +

    augmenting or overriding the annotation-based metadata with metadata from some other source

    +
  • +
+
+
+

As indicated by the name, portable CDI extensions can be used with any spec-compliant CDI implementation.

+
+
+
+
+
+

About Apache DeltaSpike

+
+
+

Apache DeltaSpike is a collection of portable CDI extensions. These ready-to-use modules enable you to integrate tested API extensions into your Java projects.

+
+
+

DeltaSpike consists of a core module and a number of optional modules for providing additional enterprise functionality to your applications. The modules include features for enhanced security with type-safe control over method invocations, integration with schedulers, injection of CDI objects into validators, and a transactional context and scope. DeltaSpike also provides boot and shutdown control over CDI containers in Java SE applications.

+
+
+

As a CDI extension, DeltaSpike must be used in conjunction with a CDI implementation and supports both JBoss Weld and Apache OpenWebBeans. DeltaSpike has been tested on a range of application servers and containers that utilize these CDI implementations, such as Apache TomEE, JBoss AS, WildFly, Oracle GlassFish, and Jetty.

+
+
+

In addition to the portable CDI extension modules, DeltaSpike provides a number of examples to show you how to use and get the most from this technology.

+
+
+
+
+

Features of DeltaSpike

+
+
+

Java EE 7 without Java EE 7!

+
+

Transactional support for non-EJB beans: The Transactional Interceptor in DeltaSpike paved the way for @Transactional in Java EE 7.

+
+
+

Injectable Servlet objects: Allows the developer to inject CDI beans on Servlets on Java EE 6/CDI 1.0 environments

+
+
+

Injectable resources: Configuration, resource bundles,…​ are easy to inject when using CDI and Apache DeltaSpike.

+
+
+

@Exclude annotation: it is possible to annotate beans which should be ignored by CDI even if they are in a CDI enabled archive on Java EE 6/CDI 1.0 environment where you cais not use @Vetoed or a veto based on ProjectStages or expressions is needed.

+
+
+

Scheduling tasks: Async processes in a non Java EE 7 environment.

+
+
+

Bean Validation integration: Allows to inject CDI beans and EJB in to Constraint-Validators.

+
+
+

BeanProvider: Access the BeanManager and CDI beans even in non managed classes like JPA-2.0 EntityListeners or Spring Beans.

+
+
+
+

JSF Improvements

+
+

Multi-window handling: Allows to manage logical windows for batches,…​ or in case of JSF it offers proper separation of browser-tabs.

+
+
+

Type-safe view-config: It allows to bind meta-data (e.g. for security) to views with a type-safe, but flexible approach. It provides a more solid navigation in case of JSF and helps a lot in the maintenance phase.

+
+
+

View-Controller: Based on type-safe view-configs view-controller annotations provide a type-safe alternative to standard-tags.

+
+
+

Injection on Converters and Validators: Allows to inject CDI beans and EJB in to JSF Converters and Validators.

+
+
+

JSF event broadcasting to CDI: Allows CDI to be notified about JSF events

+
+
+
+

Productivity Improvements

+
+

Security based on annotations: The foundation for building a robust, capable and non invasive security solution.

+
+
+

New CDI scopes: TransactionScoped, WindowScoped, ViewScoped, ViewAccess scope, Grouped conversion scope

+
+
+

Container Control and Test Control: Java SE with CDI, all with a unifying API. Start, stop, add classes to a running CDI container.

+
+
+

Data Module: An out of the box entity framework solution complete with support for container or application managed persistence contexts, as well as JDBC.

+
+
+

Decoupled Exception handling: Allows to do exception handling in one location similar to CDI Observers.

+
+
+

JMX integration: Any CDI bean can be exposed via JMX easily with one annotation.

+
+
+

Type-safe i18n messages: Localized messages are easy to use with an interface and a resource bundle, no more boilerplate and your messages now have context within the code.

+
+
+

Type-safe ProjectStages: Compared to ProjectStages in JSF, DeltaSpike provides a type-safe, but still extensible approach which can be used in CDI based applications.

+
+
+
+
+
+

Next

+
+
+

For instructions on how to start using DeltaSpike, see Configure DeltaSpike in Your Projects and Enable CDI For Your Java Environment.

+
+
+
+
+ +
+ +
+

Copyright © 2011-2014 The Apache Software Foundation, Licensed under the Apache License, Version 2.0.

+

Apache and the Apache feather logo are trademarks of The Apache Software Foundation.

+
+ +
+ + + + \ No newline at end of file Modified: websites/staging/deltaspike/trunk/content/documentation/partial-bean.html ============================================================================== --- websites/staging/deltaspike/trunk/content/documentation/partial-bean.html (original) +++ websites/staging/deltaspike/trunk/content/documentation/partial-bean.html Mon Dec 15 22:31:42 2014 @@ -6,7 +6,7 @@ -Partial-Bean +Partial-Bean Module @@ -134,7 +134,7 @@ body { data-target=".nav-collapse"> Apache DeltaSpike + href="http://deltaspike.apache.org/index.html">Apache DeltaSpike []