Difference between revisions of "Xebra Tutorial"

m (Apache)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Category:Xebra]]
 
[[Category:Xebra]]
 +
[[Xebra About|About]] | [[Xebra Installation|Installation]] |  [[Xebra Documentation|Documentation]] |  [[Xebra Tutorial|Tutorials]] | [[Xebra FAQ|Frequently Asked Questions]]
  
=Create a webapp=
 
# Setup an initial Eiffel project for your webapp. For that matter you can use this [https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/framework/web/xebra/tools/scripts/create_website.sh script] which creates all necessary files. Make sure to assign a free port to your webapp (see also [[Xebra Webapp Config File]]). The webapp has to be created in the same folder that is specified in the servers config file at webapps_root. See [[Xebra Server Config File]] for more information.
 
# Run the server and browse to http://localhost:55000/yourwebapp. The server will translate and compile your webapp. Once compiled, you should see a page displaying "Yourwebapp works!".
 
# Create xeb files for your webapp. See [[Xebra Xeb-Files]] for a documentation about xeb files. Note that you have to let the server retranslate your webapp everytime you change xeb-files or add new xeb-files. This can be done by just pressing F5 in the browser. The server automatically detects that the webapp has to be retranslated if it is set to Development Mode (see [[Xebra Server Administration]] for more info).
 
# Create the eiffel classes.
 
  
=Run Xebra Server=
+
=Server=
 +
* Run Xebra Server: [[Xebra Server Administration]]
  
# Note that you should have compiled the translator before you run the server. 
+
=Webapp=
# If you have not done so, open the file $XEBRA_DEV/eiffel_projects/xebra_server/config.ini and adapt translator, compiler, and webapps_root to your configuration (see [[Xebra Server Config File]]).
+
* Create a webapp: [[Xebra Create Webapps|Create Webapps]]
# Launch estudio and open the project $XEBRA_DEV/eiffel_projects/xebra_server/xebra_server-voidunsafe.ecf
+
* Debug a webapp: [[Xebra Debug Webapp|Debug Webapp]]
# Go to the Exceptions Handling dialog and disable DEVELOPER_EXCEPTION (this is due to a bug in the NET library that has not been fixed yet).
+
* Write a xeb file: [[Xebra Write Xeb File|Write Xeb File]]
# Open the Execution Parameters dialog and set "config.ini -d 10" as argument (see [[Xebra Server Administration]] for more info about run arguments).
+
* Add XML-RPC support ((xml_rpc is currently disabled)): [[Xebra Create XML-RPC Webapp]]
# Compile and run
+
# Browse to http://localhost:55000/helloworld/. The server now translates, generates, compiles and finally runns the helloworld application.
+
  
=Manually translate a webapp=
+
=Extend Xebra=
To manually translate, generate and compile your webapp use the following commands
+
*Create your own tag libraries: [[Xebra Create Tag Library|Create custom tag library]]
<code>
+
cd $XEBRA_DEV/httpd/htdocs/yourwebapp/
+
 
+
#Translate
+
$XEBRA_DEV/eiffel_projects/xebra_translator/EIFGENs/W_code/xebra_translator -n yourwebapp -i . -o . -t $XEBRA_DEV/eiffel_projects/xebra_translator/ -d 10
+
 
+
#Compile servlet_gen
+
ec -config .generated/servlet_gen/servlet_gen.ecf -target servlet_gen -c_compile -stop
+
 
+
#Execute servlet_gen
+
.generated/servlet_gen/EIFGENs/servlet_gen/W_code/servlet_gen .
+
 
+
#Compile webapp
+
ec -config yourwebapp.ecf -target yourwebapp -c_compile -stop
+
 
+
</code>
+
 
+
Optionally, you can add the "-clean" option for ec and the "-force" option for translator to force a complete recompilation.
+
 
+
=XML-RPC=
+
* [[Xebra Create XML-RPC Webapp]]
+

Latest revision as of 07:24, 1 September 2009

About | Installation | Documentation | Tutorials | Frequently Asked Questions


Server

Webapp

Extend Xebra