NSTRUTS

CREATED TASK: Problem with Actions in App_Code

antdimot — Wed, 25 Apr 2007 21:26:47 GMT

In many projects i use app_code directory. The current version of nstruts library not support actions locate in App_Code special directory of web project. I suggest to modify ProcessActionCreate (RequestProcessor.cs) and ActionConfig for enable load of Actions locate in App_Code.

CREATED FEATURE: Multi Assembly loading

bsorrentino — Wed, 25 Apr 2007 21:22:55 GMT

Enable support of multiple Assembly loading via configuration example:

CLOSED ISSUE: Problem on load extenal plugin assembly

bsorrentino — Wed, 25 Apr 2007 21:12:05 GMT

I have a problem when use a plugin that not loaded in web application AppDomain, in this case i think that CustomConfigurationPlugIn not configure correctly my plugin. I suggest modify it: public void Init(nstruts.ActionHandler handler, System.Web.HttpContext context) { if (m_AssemblyName != null) { Assembly a = Assembly.Load( m_AssemblyName ); Process( handler, a ); } } Thanks Regards, Tony

CREATED ISSUE: Problem on load extenal plugin assembly

bsorrentino — Wed, 25 Apr 2007 21:12:03 GMT

CREATED RELEASE: 1.1 Release Candidate

Fri, 09 Mar 2007 08:00:00 GMT

Release with bug fixing, performance improvements, ndoc completion

CREATED TASK: Problem with Actions in App_Code

antdimot — Sun, 04 Mar 2007 12:07:29 GMT

CREATED FEATURE: Multi Assembly loading

bsorrentino — Tue, 27 Feb 2007 21:09:18 GMT

Enable support of multiple Assembly loading via configuration example:

CLOSED ISSUE: Problem on load external plugin assembly

bsorrentino — Tue, 27 Feb 2007 21:02:22 GMT

UPDATED WIKI: Logging

bsorrentino — Tue, 27 Feb 2007 20:51:32 GMT

Logging

To help locate any defects that are present in the software, it's beneficial to generate log messages that tell you what the application is doing. Moreover logging could be useful for security and auditing reasons to help the system administrators to have information about accesses and operations over application. NStruts uses the Dotnet Commons Logging framework to implement logging needs.

Dotnet Common Logging Framework

The Commons Logging package is an open source Logging library that allows developers to utilize a common logging API, while maintaining the freedom to utilize many different third-party logging implementations. The Commons Logging API insulates the application and protects it from becoming coupled to a specific logging implementation.
The API provides a small set of C# classes and interfaces that an application imports and relies upon, but which has no implicit dependencies on any one logging product.
The Logging library allows developers to declaratively configure the logging implementation and the library will dynamically discover which implementation is being used. An application that utilizes the Commons Logging API does not have to be modified when the logging implementation is changed; this is the greatest benefit of such a package.

The Commons Logging package supports several different logging implementations out of the box:

Log4Net
SimpleLog (Simple text file Logger)
System.Diagnostics.Trace
Microsoft Logging and Instrumentation Application Block (LIAB).

Configuration

The NStruts sample application provide a Dotnet Commons Logging Configuration's example that use Log4Net implementation, an excerpt is outlined below.

<configSections>
 
    <!--
    =============================================
    Log4Net config section
    =============================================
    -->
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
 
</configSections>
 
<appSettings>
    <!--
    ===========================================================================
    This is the only Application Setting needed for Dotnet.Commons.Logging
    ===========================================================================
    -->
    <add key="Dotnet.Commons.Logging.LogFactory"
        value="Dotnet.Commons.Logging.Impl.Log4NetFactory,Dotnet.Commons.Logging.Log4Net" />
 
</appSettings>
 
 
<!--
=============================================
Log4Net specific  Configuration
=============================================
-->
<log4net>
    <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender" >
        <layout type="log4net.Layout.PatternLayout">
            <conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />
	</layout>
    </appender>
    <appender name="FrameworkAppender" type="log4net.Appender.FileAppender">
        <file value="nstruts.log" />
        <layout type="log4net.Layout.PatternLayout">
            <conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />
        </layout>
    </appender>
    <root>
        <level value="ALL" />
        <appender-ref ref="ConsoleAppender" />
    </root>
    <logger name="NStruts">
        <level value="TRACE" />
        <appender-ref ref="FrameworkAppender" />
    </logger>
</log4net>

UPDATED WIKI: Logging

bsorrentino — Tue, 27 Feb 2007 20:41:36 GMT

Logging

Dotnet Common Logging Framework

Log4Net
SimpleLog (Simple text file Logger)
System.Diagnostics.Trace
Microsoft Logging and Instrumentation Application Block (LIAB).

Configuration

The NStruts sample application provide a Dotnet Commons Logging Configuration's example that use Log4Net implementation, an excerpt is outlined below.

<configSections>
 
    <!--
    =============================================
    Log4Net config section
    =============================================
    -->
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
 
</configSections>
 
<appSettings>
    <!--
    ===========================================================================
    This is the only Application Setting needed for Dotnet.Commons.Logging
    ===========================================================================
    -->
    <add key="Dotnet.Commons.Logging.LogFactory"
        value="Dotnet.Commons.Logging.Impl.Log4NetFactory,Dotnet.Commons.Logging.Log4Net" />
 
</appSettings>
 
 
<!--
=============================================
Log4Net specific  Configuration
=============================================
-->
<log4net>
    <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender" >
        <layout type="log4net.Layout.PatternLayout">
            <conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />
	</layout>
    </appender>
    <appender name="FrameworkAppender" type="log4net.Appender.FileAppender">
        <file value="nstruts.log" />
        <layout type="log4net.Layout.PatternLayout">
            <conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />
        </layout>
    </appender>
    <root>
        <level value="ALL" />
        <appender-ref ref="ConsoleAppender" />
    </root>
    <logger name="NStruts">
        <level value="TRACE" />
        <appender-ref ref="FrameworkAppender" />
    </logger>
</log4net>

UPDATED WIKI: ReflectionAction

bsorrentino — Wed, 14 Feb 2007 09:00:26 GMT

ReflectionAction

The class nstruts.actions.ReflectionAction allows to map any methods (also static ones) as an NStruts's action. The mapped methods must be compliant with the following signatures:

signature	note
public nstruts.Forward MethodName( nstruts.ActionContext actionCtx, System.Web.HttpContext ctx )	public instance method
public static nstruts.Forward MethodName( nstruts.ActionContext actionCtx, System.Web.HttpContext ctx )	public static method

Configuration

Below is shown the ReflectionAction Configuration

<!-- Reflection Action -->
    <action type="nstruts.actions.ReflectionAction,nstruts" path="/[Action Name]">
      <init-params>
        <param name="type" value="[Action Type, Assembly]"/>
        <param name="method" value="[Method Name]"/>
      </init-params>
      <!-- Forward Declarations -->
    </action>

Example

This is the example provided within the NStruts's sample application (i.e. nstrutsweb)

TestReflectionAction.cs

namespace NStruts.Web.Actions
{
    public class TestReflectionAction
    {
        public Forward ActionA( ActionContext actionCtx, System.Web.HttpContext ctx )
        {
            ctx.Items["info"] = "ActionA";
 
            return actionCtx.Forwards["success"];
        }
 
        public Forward ActionB(ActionContext actionCtx, System.Web.HttpContext ctx)
        {
            ctx.Items["info"] = "ActionB";
 
            return actionCtx.Forwards["success"];
        }
 
        public static Forward ActionC(ActionContext actionCtx, System.Web.HttpContext ctx)
        {
            ctx.Items["info"] = "ActionC";
 
            return actionCtx.Forwards["success"];
        }
    }
}

TestReflectionAction configuration

<action type="nstruts.actions.ReflectionAction,nstruts" path="/actionA">
      <init-params>
        <param name="type" value="NStruts.Web.Actions.TestReflectionAction,nstrutsweb"/>
        <param name="method" value="ActionA"/>
      </init-params>
      <forward name="success" path="/ViewActionDetails.aspx" />
    </action>
    <action type="nstruts.actions.ReflectionAction,nstruts" path="/actionB">
      <init-params>
        <param name="type" value="NStruts.Web.Actions.TestReflectionAction,nstrutsweb"/>
        <param name="method" value="ActionB"/>
      </init-params>
      <forward name="success" path="/ViewActionDetails.aspx" />
    </action>
    <action type="nstruts.actions.ReflectionAction,nstruts" path="/actionC">
      <init-params>
        <param name="type" value="NStruts.Web.Actions.TestReflectionAction,nstrutsweb"/>
        <param name="method" value="ActionC"/>
      </init-params>
      <forward name="success" path="/ViewActionDetails.aspx" />
    </action>

UPDATED WIKI: Custom Attributes

bsorrentino — Wed, 14 Feb 2007 08:49:34 GMT

Custom Attributes

The NStruts Custom Attributes allows to publish actions without needs to write configuration items (i.e. XML tags).
Outlined below there are the available NStruts attributes:

namespace NStruts.Attributes

ActionAttribute
ActionContainerAttribute
ActionParameterAttribute - not supported yet
FormObjectAttribute
ForwardAttribute

[Action]

Applies to	Class and Method
Allow Multiple	false
constructor	Action( string path )
Example	[Action( "/custom" )]
class	NStruts.Attributes.ActionAttribute

This attribute can be used in order to declare a new NStruts's Action

property	type	feature
Name	string	Form-Object's Name associated to action
Scope	string	Form-Object's scope (context\|session\|application\|cache)
Path	string	Action's path - mandatory

[ActionContainer]

Applies to	Class and Method
Allow Multiple	false
constructor	ActionContainer()
Example	[ActionContainer]
class	NStruts.Attributes.ActionContainerAttribute

This attribute can be used in order to declare that within class there are Method Level Actions (see ReflectionAction )

[Forward]

Applies to	Class and Method
Allow Multiple	true
constructor	Forward( string name, string path )
Example	[Forward( "success", "/ViewActionDetails.aspx")]
class	NStruts.Attributes.ForwardAttribute

This attribute can be used in order to declare a new action's forward. (w) It has sense only if is declared an ActionAttribute first

property	type	feature
Name	string	name that identify the forward object - mandatory
Path	string	Forward's path - mandatory
Redirect	bool	it indicates if you want use the http redirect to invoke the forward's path (i) default is false

[FormObject]

Applies to	Class
Allow Multiple	false
constructor	FormObject( string name )
Example	[FormObject( "user" )]
class	NStruts.Attributes.FormObjectAttribute

This attribute can be used in order to delclare a new NStruts's FormObject

property	type	feature
Name	string	Form-Object's Name - mandatory

UPDATED WIKI: Custom Attributes

bsorrentino — Wed, 14 Feb 2007 08:47:58 GMT

Custom Attributes

The NStruts Custom Attributes allows to publish actions without needs to write configuration items (i.e. XML tags).
Outlined below there are the available NStruts attributes:

namespace NStruts.Attributes

ActionAttribute
ActionContainerAttribute
ActionParameterAttribute - not supported yet
FormObjectAttribute
ForwardAttribute

[Action]

Applies to	Class and Method
Allow Multiple	false
constructor	Action( string path )
Example	[Action( "/custom" )]
class	NStruts.Attributes.ActionAttribute

This attribute can be used in order to declare a new NStruts's Action

property	type	feature
Name	string	Form-Object's Name associated to action
Scope	string	Form-Object's scope (context\|session\|application\|cache)
Path	string	Action's path - mandatory

[ActionContainer]

Applies to	Class and Method
Allow Multiple	false
constructor	ActionContainer()
Example	[ActionContainer]
class	NStruts.Attributes.ActionContainerAttribute

This attribute can be used in order to declare that within class there are Method Level Actions (see ReflectionAction )

[Forward]

Applies to	Class and Method
Allow Multiple	true
constructor	Forward( string name, string path )
Example	[Forward( "success", "/ViewActionDetails.aspx")]
class	NStruts.Attributes.ForwardAttribute

This attribute can be used in order to declare a new action's forward. (w) It has sense only if is declared an ActionAttribute first

property	type	feature
Name	string	name that identify the forward object - mandatory
Path	string	Forward's path - mandatory
Redirect	bool	it indicates if you want use the http redirect to invoke the forward's path (i) default is false

[FormObject]

Applies to	Class
Allow Multiple	false
constructor	FormObject( string name )
Example	[FormObject( "user" )]
class	NStruts.Attributes.FormObjectAttribute

This attribute can be used in order to delclare a new NStruts's FormObject

property	type	feature
Name	string	Form-Object's Name - mandatory

UPDATED WIKI: Custom Configuration PlugIn

bsorrentino — Wed, 14 Feb 2007 08:42:49 GMT

CustomConfigurationPlugIn

The nstruts.actions.CustomConfigurationPlugIn plugIn class enables the support of the custom attributes to declare Actions, Forwards and Form-Objects.

Configuration

To configure this plug-in we have to put, within nstruts.config, the folowing configuration

<plug-in type="nstruts.actions.CustomConfigurationPlugIn,nstruts">
  <set-property property="AssemblyName" value="[assembly name]"/>
</plug-in>

AssemblyName parameter

It defines the assembly where the plugin will scan to find custom attributes.

UPDATED WIKI: Home

bsorrentino — Wed, 14 Feb 2007 08:38:59 GMT

The jakarta Struts framework porting on ASP.NET

Goals

Nstruts's goal is to provide a easy way to reuse Struts know-how in .NET environment. Moreover it would try to improve the original java edition using all the stuff provided by ASP.NET technology

Dependencies

NStruts depends upon

Project Information

NStruts is originally hosted in GotDotNet

Features

Logging
Configureless approach

UPDATED WIKI: Custom Attributes

bsorrentino — Tue, 13 Feb 2007 16:41:07 GMT

Custom Attributes

The NStruts Custom Attributes allows to publish actions without needs to write configuration items (i.e. XML tags).
Outlined below there are the available NStruts attributes:

namespace NStruts.Attributes

ActionAttribute
ActionContainerAttribute
ActionParameterAttribute - not supported yet
FormObjectAttribute
ForwardAttribute

[Action]

Applies to	Class and Method
Allow Multiple	false
constructor	Action( string path )
Example	[Action( "/custom" )]
class	NStruts.Attributes.ActionAttribute

This attribute can be used in order to declare a new NStruts's Action

property	type	feature
Name	string	Form-Object's Name associated to action
Scope	string	Form-Object's scope (context\|session\|application\|cache)
Path	string	Action's path - mandatory

[ActionContainer]

Applies to	Class and Method
Allow Multiple	false
constructor	ActionContainer()
Example	[ActionContainer]
class	NStruts.Attributes.ActionContainerAttribute

This attribute can be used in order to declare that within class there are Method Level Actions (see ReflectionAction )

[Forward]

Applies to	Class and Method
Allow Multiple	true
constructor	Forward( string name, string path )
Example	[Forward( "success", "/ViewActionDetails.aspx")]
class	NStruts.Attributes.ForwardAttribute

This attribute can be used in order to declare a new action's forward. (w) It has sense only if is declared an ActionAttribute first

property	type	feature
Name	string	name that identify the forward object - mandatory
Path	string	Forward's path - mandatory
Redirect	bool	it indicates if you want use the http redirect to invoke the forward's path (i) default is false

[FormObject]

Applies to	Class
Allow Multiple	false
constructor	FormObject( string name )
Example	[FormObject( "user" )]
class	NStruts.Attributes.FormObjectAttribute

This attribute can be used in order to delclare a new NStruts's FormObject

property	type	feature
Name	string	Form-Object's Name - mandatory

UPDATED WIKI: Custom Attributes

bsorrentino — Tue, 13 Feb 2007 16:40:20 GMT

The NStruts Custom Attributes allows to publish actions without needs to write configuration items (i.e. XML tags).
Outlined below there are the available NStruts attributes:

namespace NStruts.Attributes

ActionAttribute
ActionContainerAttribute
ActionParameterAttribute - not supported yet
FormObjectAttribute
ForwardAttribute

[Action]

Applies to	Class and Method
Allow Multiple	false
constructor	Action( string path )
Example	[Action( "/custom" )]
class	NStruts.Attributes.ActionAttribute

This attribute can be used in order to declare a new NStruts's Action

property	type	feature
Name	string	Form-Object's Name associated to action
Scope	string	Form-Object's scope (context\|session\|application\|cache)
Path	string	Action's path - mandatory

[ActionContainer]

Applies to	Class and Method
Allow Multiple	false
constructor	ActionContainer()
Example	[ActionContainer]
class	NStruts.Attributes.ActionContainerAttribute

This attribute can be used in order to declare that within class there are Method Level Actions (see ReflectionAction )

[Forward]

Applies to	Class and Method
Allow Multiple	true
constructor	Forward( string name, string path )
Example	[Forward( "success", "/ViewActionDetails.aspx")]
class	NStruts.Attributes.ForwardAttribute

This attribute can be used in order to declare a new action's forward. (w) It has sense only if is declared an ActionAttribute first

property	type	feature
Name	string	name that identify the forward object - mandatory
Path	string	Forward's path - mandatory
Redirect	bool	it indicates if you want use the http redirect to invoke the forward's path (i) default is false

[FormObject]

Applies to	Class
Allow Multiple	false
constructor	FormObject( string name )
Example	[FormObject( "user" )]
class	NStruts.Attributes.FormObjectAttribute

This attribute can be used in order to delclare a new NStruts's FormObject

property	type	feature
Name	string	Form-Object's Name - mandatory

UPDATED WIKI: Home

bsorrentino — Tue, 13 Feb 2007 16:31:54 GMT

The jakarta Struts framework porting on ASP.NET

Goals

Nstruts's goal is to provide a easy way to reuse Struts know-how in .NET environment. Moreover it would try to improve the original java edition using all the stuff provided by ASP.NET technology

Dependencies

NStruts depends upon

Project Information

NStruts is originally hosted in GotDotNet

Features

Logging
Configureless approach

Custom Attributes

UPDATED WIKI: Home

bsorrentino — Tue, 13 Feb 2007 16:25:34 GMT

The jakarta Struts framework porting on ASP.NET

Goals

Nstruts's goal is to provide a easy way to reuse Struts know-how in .NET environment. Moreover it would try to improve the original java edition using all the stuff provided by ASP.NET technology

Dependencies

NStruts depends upon

Project Information

NStruts is originally hosted in GotDotNet

Features

LOGGING

UPDATED WIKI: Logging

bsorrentino — Mon, 12 Feb 2007 23:08:51 GMT

Logging

Dotnet Common Logging Framework

Log4Net
SimpleLog (Simple text file Logger)
System.Diagnostics.Trace
Microsoft Logging and Instrumentation Application Block (LIAB).

Configuration

The NStruts sample application provide a Dotnet Commons Logging configuration's example that use Log4Net implementation, an excerpt is outlined below.

<configSections>
 
    <!--
    =============================================
    Log4Net config section
    =============================================
    -->
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
 
</configSections>
 
<appSettings>
    <!--
    ===========================================================================
    This is the only Application Setting needed for Dotnet.Commons.Logging
    ===========================================================================
    -->
    <add key="Dotnet.Commons.Logging.LogFactory"
        value="Dotnet.Commons.Logging.Impl.Log4NetFactory,Dotnet.Commons.Logging.Log4Net" />
 
</appSettings>
 
 
<!--
=============================================
Log4Net specific  Configuration
=============================================
-->
<log4net>
    <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender" >
        <layout type="log4net.Layout.PatternLayout">
            <conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />
	</layout>
    </appender>
    <appender name="FrameworkAppender" type="log4net.Appender.FileAppender">
        <file value="nstruts.log" />
        <layout type="log4net.Layout.PatternLayout">
            <conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />
        </layout>
    </appender>
    <root>
        <level value="ALL" />
        <appender-ref ref="ConsoleAppender" />
    </root>
    <logger name="NStruts">
        <level value="TRACE" />
        <appender-ref ref="FrameworkAppender" />
    </logger>
</log4net>