RE: pageflow tutorial question (and doc update)

[Steve Hanson <st...@bea.com>]

Thanks all for the tutorial bugs.
I will post all the fixes within the next hour.

Here is an outline of the docs that will be posted in the run up to ApacheCon.  Check http://incubator.apache.org/beehive/index.html for ongoing updates.


General Beehive
	- a guide to building the beehive tree, running the samples, etc.

Page Flows
	- a more detailed programming guide, including info on error handling, validation, security, data binding, etc.
	- a reference for Page Flow annotations (@Jpf.Controller, etc.)
	- on going tutorial updates, including using controls in a Page Flow

Controls
	- a control authoring guide (including info on custom annotations, etc.)
	- a control tutorial (coming later today)

Web Services
	- a tutorial
	- a (small-ish) authoring guide

-Steve Hanson


-----Original Message-----
From: Bryan Che [mailto:bche@redhat.com]
Sent: Thursday, October 14, 2004 8:45 AM
To: Beehive Users
Subject: Re: pageflow tutorial question


Eddie, it's great to hear that there will be releases and new docs soon. 
  Could someone publish a list of what's coming and when?  That would be 
most helpful for tracking Beehive and participating in the community.

Thanks,

Bryan

Eddie O'Neil wrote:
> 
>   One thing to mention here...
> 
>   Right now, the tutorial is running against the Beehive tree as it is 
> built out of SVN.  In a week or two once a Beehive distribution is 
> producable as part of the build (and eventually downloadable from the 
> website), the tutorial will shift all of these commands to run against 
> the Ant build files for building webapps / WSM that are shipped as part 
> of the distribution.  These will be different than the ones currently 
> referenced below, though you will be able to use them similarly.
> 
>   You'll also be able to run the webapps against any 5.x version of 
> Tomcat since the distribution doesn't include Tomcat (or Axis).
> 
>   We're working on getting some of this done right now.
> 
>   So, the commands below are great for now, but it will be easier at 
> some point in the near future.
> 
>   <g>
> 
> Eddie
> 
> ps -- thanks for all the feedback on and interest in the tutorials!
> 
> 
> 
> 
> Leverett, Paul Van wrote:
> 
>> Hi,
>>
>> I have another suggestion for the tutorial. The following string is used
>> quite a bit throughout the tutorial. It can be set to an environment
>> variable to save typing and make the tutorial more readable.
>>
>> "C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_t
>> utorial "
>>
>> ---------------------------------------
>> Set the environment variable
>>
>> set
>> PF_TUTORIAL=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps
>> \pageflow_tutorial
>> ---------------------------------------
>>
>> Commands like
>>
>> "ant -f webappTemplate.xml
>> -Dwebapp.dist.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\w
>> ebapps\pageflow_tutorial "
>>
>> becomes
>>
>> "ant -f webappTemplate.xml -Dwebapp.dist.dir=%PF_TUTORIAL%"
>>
>> -----------------------------------------
>>
>> Instructions like
>>
>> "In the directory
>> C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tu
>> torial, create a file named index.jsp."
>>
>> becomes
>>
>> "In the directory PF_TUTORIAL, create a file named index.jsp"
>>
>> -------------------------------------------
>>
>> Thanks,
>> Paul
>>
>> -----Original Message-----
>> From: Pedro Lopez [mailto:pedroplopez@yahoo.com] Sent: Thursday, 
>> October 14, 2004 7:48 AM
>> To: Beehive Users
>> Subject: Re: pageflow tutorial question
>>
>> Steve,
>> I also found some inconsistency in the instructions, take a look at
>> this:
>>
>> Create a directory named installedat
>> C:/beehive-src/trunk/installed.
>>
>> Unzip the file
>> C:/beehive-src/trunk/external/ant/apache-ant-1.6.2-bin.zip
>> into C:/beehive-src/Beehive/installed.
>>
>> The first step talks about the "trunk\installed"
>> folder, but the second step talks about
>> "Beehive\installed" folder.
>>
>> Could you correct this problem?
>> Thanks
>> Pedro
>> --- Bryan Che <bc...@redhat.com> wrote:
>>
>>
>>> Steve, here are a few more bugs I found in the
>>> tutorial:
>>>
>>> Step 3:
>>> Shutdown Tomcat Server
>>>
>>> At the command prompt, enter:
>>
>>
>> C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.bat
>>
>>> ***
>>> should be "shutdown" instead of "startup"
>>> ----------------------
>>>
>>> Step 5:
>>> To Process the Submitted Data
>>>
>>> Edit the processData method in the Controller.jpf file so it appears 
>>> as follows. Code to add appears in red.
>>>
>>> ***
>>> There is no red
>>> ----------------------
>>>
>>> To Create a JSP Page to Display Submitted Data
>>>
>>> Create a file named displayData.jsp in the directory
>>>
>>> [TOMCAT_HOME]/directory/pageflow_tutorial. Edit showData.jsp so it 
>>> appears as follows.
>>>
>>> ***
>>> "displayData.jsp" should be "showData.jsp"
>>> ----------------------
>>>
>>> I still occassionally get errors, but they eventually go away after 
>>> cleaning and rebuilding--like you said.
>>>
>>> Bryan
>>>
>>> Bryan Che wrote:
>>>
>>>> Hi, I found the problem.  In Step 3, your
>>>
>>>
>>> Controller.jpf source is
>>>
>>>> missing the "@Jpf.Controller" annotation for the
>>>
>>>
>>> Controller class. After
>>>
>>>> adding that annotation, I was able to navigate to
>>>
>>>
>>> page2 fine.
>>>
>>>> Bryan
>>>>
>>>> Steve Hanson wrote:
>>>>
>>>>
>>>>> Ok, that is a real problem.
>>>>>
>>>>> Are you stopping and restarting Tomcat between
>>>
>>>
>>> each step?  That may
>>>
>>>>> make a difference.
>>>>>
>>>>> Also, I just updated the tutorial as of 4 minutes
>>>
>>>
>>> ago.  So the changes
>>>
>>>>> should be public by now.
>>>>>
>>>>> -Steve H.
>>>>>
>>>>> -----Original Message-----
>>>>> From: Bryan Che [mailto:bche@redhat.com]
>>>>> Sent: Wednesday, October 13, 2004 2:52 PM
>>>>> To: Beehive Users
>>>>> Subject: Re: pageflow tutorial question
>>>>>
>>>>>
>>>>> Well, it's more than an annoyance in that the
>>>
>>>
>>> tutorial/beehive doesn't
>>>
>>>>> work. =p  I haven't seen the app work at all yet
>>>
>>>
>>> beyond the index page.
>>>
>>>>> Bryan
>>>>>
>>>>> Steve Hanson wrote:
>>>>>
>>>>>
>>>>>> I don't know of any other trick to try.
>>>>>>
>>>>>> One question: is this error anything more than
>>>
>>>
>>> an annoyance?  Or is
>>>
>>>>>> it interfering with the tutorial in some other
>>>
>>>
>>> way?
>>>
>>>>>> BTW: I will be updating the tutorial tonight, so
>>>
>>>
>>> it should work
>>>
>>>>>> smoother in other ways.  You are no longer
>>>
>>>
>>> directed to open and close
>>>
>>>>>> all those command shells, etc.
>>>>>>
>>>>>> -Steve Hanson
>>>>>>
>>>>>> -----Original Message-----
>>>>>> From: Bryan Che [mailto:bche@redhat.com]
>>>>>> Sent: Wednesday, October 13, 2004 2:17 PM
>>>>>> To: Steve Hanson
>>>>>> Cc: beehive-user@incubator.apache.org
>>>>>> Subject: Re: pageflow tutorial question
>>>>>>
>>>>>>
>>>>>> Hi Steve, thanks for the quick response (I'm
>>>
>>>
>>> cc'ing to beehive-user
>>>
>>>>>> in case this is useful to anyone else).  I tried
>>>
>>>
>>> completely deleting
>>>
>>>>>> my WEB-INF directory, recreating it, and then
>>>
>>>
>>> rebuilding my webapp. 
>>>
>>>>>> I still get the "Action Not Found" error.  Do
>>>
>>>
>>> you know if there's
>>>
>>>>>> anything else I can try?
>>>>>>
>>>>>> Thanks,
>>>>>>
>>>>>> Bryan
>>>>>>
>>>>>> Steve Hanson wrote:
>>>>>>
>>>>>>
>>>>>>
>>>>>>> Hi Bryan:
>>>>>>>
>>>>>>> Yeah, I get that too.  I only get it
>>>
>>>
>>> intermittently.  If you clean
>>>
>>>>>>> out all your gen'd files in WEB-INF (like the
>>>
>>>
>>> classes,
>>>
>>>>>>> .pageflow-struts-generated, and .tmpbeansrc
>>>
>>>
>>> folders), and compile
>>>
>>>>>>> again, you won't see the error.  But if you
>>>
>>>
>>> compile without cleaning
>>>
>>>>>>> out the gen'd files, the error occurs ~80% of
>>>
>>>
>>> the time (at least for
>>>
>>>>>>> me).
>>>>>>>
>>>>>>> I don't think this is a problem with the
>>>
>>>
>>> tutorial code...it is some
>>>
>>>>>>> problem with the compiler.
>>>>>>>
>>>>>>> -Steve Hanson
>>>>>>>
>>>>>>> -----Original Message-----
>>>>>>> From: Bryan Che [mailto:bche@redhat.com]
>>>>>>> Sent: Wednesday, October 13, 2004 1:56 PM
>>>>>>> To: Steve Hanson
>>>>>>> Subject: pageflow tutorial question
>>>>>>>
>>>>>>>
>>>>>>> Hi Steve, I've been trying out your pageflow
>>>
>>>
>>> tutorial on beehive. 
>>>
>>>>>>> But, at step 3, the navigation step, I get the
>>>
>>>
>>> following error after
>>>
>>>>>>> starting tomcat and clicking on the link to
>>>
>>>
>>> page2.:
>>>
>>>>>>> Page Flow Error - Action Not Found
>>>>>>> Page Flow:    Global.app
>>>>>>> Action:    toPage2
>>>>>>> Form:    null
>>>>>>>
>>>>>>> Unable to find matching action toPage2.
>>>>>>>
>>>>>>> The toPage2 method is in my Controller.jpf
>>>
>>>
>>> file.  But, I did notice
>>>
>>>>>>> some warnings when trying to build the webapp:
>>>>>>>
>>>>>>> /home/bche/src/svn/beehive/trunk/test/ant/>ant
>>>
>>>
>>> -f buildWebapp.xml
>>>
>>>>>>> build.webapp
>>>>>>>
>>>
>> -Dwebapp.dir=/home/bche/src/svn/beehive/trunk/installed/jakarta-tomcat-5
>> .0.25/webapps/pageflow_tutorial
>>
>>>>>>> Buildfile: buildWebapp.xml
>>>>>>>
>>>>>>> build.webapp:
>>>>>>>  [delete] Deleting directory
>>>>>>>
>>>
>> /home/bche/src/svn/beehive/trunk/installed/jakarta-tomcat-5.0.25/webapps
>> /pageflow_tutorial/WEB-INF/.tmpbeansrc
>>
>>>>>>> [xmlbeanbuild] Could not find any xsd or wsdl
>>>
>>>
>>> files to process.
>>>
>>>>>>>    [echo] ========== Complie Java source in
>>>
>>>
>>> WEB-INF/src ==========
>>>
>>>>>>>    [echo] netui-compiler.jar:
>>>
>>>
>> /home/bche/src/svn/beehive/trunk/netui/build/lib/beehive-netui-compiler.
>> jar
>>
>>>>>>>    [echo] controls.jar:
>>>
>>>
>> /home/bche/src/svn/beehive/trunk/controls/build/jars/controls.jar
>>
>>>>>>>    [echo] ========== Generate and compile
>>>
>>>
>>> controls ==========
>>>
>>>>>>>   [mkdir] Created dir:
>>>
>>>
>> /home/bche/src/svn/beehive/trunk/installed/jakarta-tomcat-5.0.25/webapps
>> /pageflow_tutorial/WEB-INF/.tmpbeansrc
>>
>> === message truncated ===
>>
>>
>>
>>        
>> __________________________________
>> Do you Yahoo!?
>> Yahoo! Mail Address AutoComplete - You start. We finish.
>> http://promotions.yahoo.com/new_mail