File Coverage

blib/lib/ASP4.pm

Criterion	Covered	Total	%
statement	6	6	100.0
branch			n/a
condition			n/a
subroutine	2	2	100.0
pod			n/a
total	8	8	100.0

package ASP4;

use strict;
use warnings 'all';
our $VERSION = '0.001_05';


1;# return true:

=pod

=head1 NAME

ASP4 - Fast, Simple, Scalable Web Development

=head1 DESCRIPTION

ASP4 is a web development environment.  It takes lessons learned from other web
development environments such as Microsoft ASP.Net, Ruby on Rails and Catalyst.

This project has some top-level priorities:

=over 4

=item * Test-Driven

ASP4 is made for the test-writing fanatic.  Anything your web application might do
can be tested - using L, L and L.

ASP4 supports test-fixtures, properties files (useful for error messages, etc)
and uses a simple plain-text JSON configuration file format.

=item * Keep It Simple, Smartypants (KISS)

ASP4 provides a clean slate on which to build web applications.  It does not go
out of its way to do everything for the developer, and does not enforce any kind
of specific coding style.

=item * Go Faster

On a server configuration which can serve a static "HELLO WORLD" page at 12,000 requests per second,
ASP4 can serve the "HELLO WORLD" equivalent at 1,200 requests per second.  A more
complex page that involves deeply-nested MasterPages and server-side includes may
come in at 1,000 requests per second.

=item * Easy to Learn

The intrinsic ASP objects - C<$Request>, C<$Response>, C<$Session>, C<$Server> -
and ASP4 extensions - C<$Form>, C<$Config>, C<$Stash> - focus developer attention
on a simplified environment, while still offering direct access to the "metal" underneath.

The classic Perl L C<$r> and L objects are always accessible
via the L api.

=item * Easy to Scale

Session state can be stored in a database (or distributed via memcached) which means
that ASP4 web applications can be served by one machine or many machines.

B is in the DNA of ASP4.

=back

=head1 EXAMPLES

=head2 ASP Scripts

ASP scripts are pretty much as you might expect, if you've ever seen an ASP script before:



      Welcome Back, <%= $Session->{email} || "You" %>!
  <%
    for(1..5) {
  %>
    <%= $_ %>: Hello, World!
  <%
    }
  %>

      Favorite Color: <%= $Server->HTMLEncode( $Form->{favorite_color} ) %>




=head2 Form Handlers

Like "Controllers" in the MVC paradigm, "Handlers" respond to user input without
any of the Perl-embedded-in-HTML distraction.

Some URL-masking happens, so a request to C would go to:

  package hello::world;

  use strict;
  use warnings 'all';
  use base 'ASP4::FormHandler';
  use vars __PACKAGE__->VARS; # Import $Request, $Response, $Session, etc:

  sub run {
    my ($self, $context) = @_;

    $Response->SetCookie(
      name    => "last-seen",
      value   => scalar(localtime()),
      expires => 30 * 60 * 60 * 24, # 30 days:
    );
    $Response->Write("Hello World!");
  }

  1;# return true:

=head2 MasterPages

Similar to ASP.Net's concept of MasterPages, ASP4's MasterPages allow Page Composition.

Example: (eg: C)

  <%@ MasterPage %>


       </td>
</tr>

<tr>
<td  class="h" >
<a name="124">124</a>
</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td class="s">         <asp:ContentPlaceHolder id="meta_title">Default Title</asp:ContentPlaceHolder> </td>
</tr>

<tr>
<td  class="h" >
<a name="125">125</a>
</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td class="s">
      " />
      " />



        HELLO


        Content coming soon!




If you access the page directly, you would see the default content displayed.

=head2 Child Pages

Child pages inherit from MasterPages - exactly like child classes inherit from super classes.

Example: (eg: C)

  <%@ Page UseMasterPage="/masters/global.asp" %>

  Child Title

  child keywords

  child description

  The Child Page

  Hello from the Child Page - hooray!

The result after accessing C you would see the following:



       </td>
</tr>

<tr>
<td  class="h" >
<a name="164">164</a>
</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td class="s">         Child Title </td>
</tr>

<tr>
<td  class="h" >
<a name="165">165</a>
</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td class="s">





        The Child Page


        Hello from the Child Page - hooray!




=head2 MasterPage Inheritance

MasterPages can also inherit from other MasterPages.

Example: (eg: C)

  <%@ MasterPage %>
  <%@ Page UseMasterPage="/masters/global.asp" %>

  Submaster Title

  submaster keywords

  submaster description

  The Submaster Page


    The first part.
    Hello from the subsection!
    The final part.


A page inheriting from C could get by with only:

  <%@ Page UseMasterPage="/masters/submaster.asp" %>


    Hello from the subsection!


The resulting content would be:



       </td>
</tr>

<tr>
<td  class="h" >
<a name="215">215</a>
</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td class="s">         Submaster Title </td>
</tr>

<tr>
<td  class="h" >
<a name="216">216</a>
</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td class="s">





        The Submaster Page


    The first part.
    Hello from the subsection!
    The final part.




B<**THEN**> you could further subclass like this:

  <%@ Page UseMasterPage="/masters/submaster.asp" %>

  My Title!

  My Content Too!

The output would be:



       </td>
</tr>

<tr>
<td  class="h" >
<a name="245">245</a>
</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td class="s">         My Title! </td>
</tr>

<tr>
<td  class="h" >
<a name="246">246</a>
</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td >

 

</td>

<td class="s">





        The Submaster Page



    The first part.
    My Content Too!
    The final part.





=head1 AUTHOR

John Drago

=head1 COPYRIGHT

This software is Free software and may be used and redistributed under the same
terms as perl itself.

=cut