Revision: 5473
Author: bdfer
...@onebusaway.org
Date: Sun Feb 19 01:28:05 2012
Log: Edited wiki page DeveloperQuickStart through web user interface.
http://code.google.com/p/onebusaway/source/detail?r=5473 Modified:
/wiki/DeveloperQuickStart.wiki
=======================================
--- /wiki/DeveloperQuickStart.wiki Sat Nov 5 05:02:15 2011
+++ /wiki/DeveloperQuickStart.wiki Sun Feb 19 01:28:05 2012
@@ -1,212 +1,1 @@
-#summary Developer Quick Start Guide for project setup.
-#labels Featured,GettingStarted
-
-<wiki:toc />
-
-This quick start guide is designed to get you up and running with
the !OneBusAway source code as quickly as possible. For more general
documentation on !OneBusAway development, check out [HackingOneBusAway
Hacking OneBusAway].
-
-= Getting the Source =
-
-Use your favorite SVN client of choice to grab the source-code for the
`onebusaway-application-modules` project, or check it out directly within
Eclipse:
-
-{{{
-svn checkout
http://onebusaway.googlecode.com/svn/onebusaway-application-modules/t...
-}}}
-
-All check out the [GettingTheSource general guide to OBA source code
access].
-
-= Importing the code into Eclipse =
-
-See the [ImportingTheSourceIntoEclipse the general guide to importing OBA
source code into Eclipse].
-
-
-= Building a Transit Data Bundle =
-
-A transit data bundle collects all the transit data that is needed to
power !OneBusAway, bundle into a series of files and optimized data
structures.
-
-At a minimum, you need a GTFS feed of static schedule data for your target
transit agency. You can quickly build a bundle with the following command:
-
-{{{
-org.onebusaway.transit_data_federation.bundle.FederatedTransitDataBundleCr eatorMain
- /path/to/your/GTFS.zip
- /path/to/your/transit_data_bundle
-}}}
-
-See the [AdminTransitDataBundle general guide for creating a transit data
bundle].
-
-= Choosing a Database =
-
-By default, !OneBusAway supports an embedded HSQLDB instance for building
transit data bundles and persisting user data. However, you may wish to
use a more full-featured database for managing your persistent application
data.
-
-If you do choose a different database, note:
-
- * Make sure the JDBC adapter jar for your database is on your classpath
and that you've set the appropriate Hibernate dialect.
- * See [DatabaseSetupAndConfiguration database setup and configuration]
for more details.
-
-= Setting up a Tomcat server in Eclipse =
-
-See the [SettingUpATomcatServerInEclipse Tomcat+Eclipse setup guide]. You
will need one server instance called `onebusaway` and it will need the
following webapp modules:
-
- * `onebusaway-transit-data-federation-webapp`
- * `onebusaway-api-webapp`
- * `onebusaway-webapp`
-
-= Configuring onebusaway-transit-data-federation-webapp =
-
-You'll need to create the following file:
-
-{{{
-onebusaway-transit-data-federation-webapp/src/main/resources/data-sources. xml
-}}}
-
-Here is an example file to get you started:
-{{{
-<?xml version="1.0" encoding="UTF-8"?>
-<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:context="http://www.springframework.org/schema/context"
- xsi:schemaLocation="
- http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
- http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd">
-
- <!-- Database Connection Configuration -->
- <bean id="dataSource"
class="org.springframework.jdbc.datasource.DriverManagerDataSource">
- <property name="driverClassName" value="org.hsqldb.jdbcDriver" />
- <property name="url"
value="jdbc:hsqldb:file:/path/to/your/transit_data_bundle/org_onebusaway_da tabase"
/>
- <property name="username" value="sa" />
- <property name="password" value="" />
- </bean>
-
- <bean id="mutableDataSource"
class="org.springframework.jdbc.datasource.DriverManagerDataSource">
- <property name="driverClassName" value="org.hsqldb.jdbcDriver" />
- <property name="url"
value="jdbc:hsqldb:file:/path/to/your/transit_data_bundle/org_onebusaway_da tabase_mutable"
/>
- <property name="username" value="sa" />
- <property name="password" value="" />
- </bean>
-
- <bean
class="org.onebusaway.container.spring.SystemPropertyOverrideConfigurer">
- <property name="order" value="-2" />
- <property name="properties">
- <props>
- <prop
key="bundlePath">/path/to/your/transit_data_bundle</prop>
- </props>
- </property>
- </bean>
-
- <bean
class="org.onebusaway.container.spring.PropertyOverrideConfigurer">
- <property name="properties">
- <props>
- <prop
key="cacheManager.cacheManagerName">org.onebusaway.transit_data_federation_ webapp.cacheManager</prop>
- </props>
- </property>
- </bean>
-
-</beans>
-}}}
-
-= Configuring onebusaway-api-webapp =
-
-You'll need to create the following file:
-
-{{{
-onebusaway-api-webapp/src/main/resources/data-sources.xml
-}}}
-
-
-Here is an example file to get you started:
-
-{{{
-<?xml version="1.0" encoding="UTF-8"?>
-<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:context="http://www.springframework.org/schema/context"
- xsi:schemaLocation="
- http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
- http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd">
-
- <bean id="transitDataService"
class="org.springframework.remoting.caucho.HessianProxyFactoryBean">
- <property name="serviceUrl"
-
value="http://localhost:8080/onebusaway-transit-data-federation-webapp/remot..."
/>
- <property name="serviceInterface"
value="org.onebusaway.transit_data.services.TransitDataService" />
- </bean>
-
- <!-- Database Connection Configuration -->
- <bean id="dataSource"
class="org.springframework.jdbc.datasource.DriverManagerDataSource">
- <property name="driverClassName" value="org.hsqldb.jdbcDriver" />
- <property name="url"
value="jdbc:hsqldb:file:/path/to/your/transit_data_bundle/org_onebusaway_us ers"
/>
- <property name="username" value="sa" />
- <property name="password" value="" />
- </bean>
-
- <bean id="externalGeocoderImpl"
class="org.onebusaway.geocoder.impl.FixedGeocoderImpl">
- <property name="lat" value="40.71951191642972" />
- <property name="lon" value="-73.99991512298584" />
- <property name="city" value="New York" />
- <property name="state" value="NY" />
- <property name="postalCode" value="10013" />
- </bean>
-
- <bean id="serviceArea"
class="org.onebusaway.presentation.impl.DefaultServiceAreaServiceImpl" />
-
-</beans>
-}}}
-
-
-= Configuring onebusaway-webapp =
-
-You'll need to create the following file:
-
-{{{
-onebusaway-webapp/src/main/resources/data-sources.xml
-}}}
-
-Here is an example file to get you started:
-
-{{{
-<?xml version="1.0" encoding="UTF-8"?>
-<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:context="http://www.springframework.org/schema/context"
- xsi:schemaLocation="
- http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
- http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd">
-
- <bean id="transitDataService"
class="org.springframework.remoting.caucho.HessianProxyFactoryBean">
- <property name="serviceUrl"
-
value="http://localhost:8080/onebusaway-transit-data-federation-webapp/remot..."
/>
- <property name="serviceInterface"
value="org.onebusaway.transit_data.services.TransitDataService" />
- </bean>
-
- <!-- Database Connection Configuration -->
- <bean id="dataSource"
class="org.springframework.jdbc.datasource.DriverManagerDataSource">
- <property name="driverClassName" value="org.hsqldb.jdbcDriver" />
- <property name="url"
value="jdbc:hsqldb:file:/path/to/your/transit_data_bundle/org_onebusaway_us ers"
/>
- <property name="username" value="sa" />
- <property name="password" value="" />
- </bean>
-
- <bean id="externalGeocoderImpl"
class="org.onebusaway.geocoder.impl.FixedGeocoderImpl">
- <property name="lat" value="40.71951191642972" />
- <property name="lon" value="-73.99991512298584" />
- <property name="city" value="New York" />
- <property name="state" value="NY" />
- <property name="postalCode" value="10013" />
- </bean>
-
- <bean id="serviceArea"
class="org.onebusaway.presentation.impl.DefaultServiceAreaServiceImpl" />
-
-</beans>
-}}}
-
-Notes:
- * Update the `dataSource` definitions to point to the database of your
choice.
- * Make sure the port number and url in the `transitDataService`
definition matches your Tomcat setup.
-
-= Running Tomcat =
-
-Hopefully you've now got a Tomcat instance called `onebusaway` that
includes the following two webapp modules:
-
- * `onebusaway-transit-data-federation-webapp`
- * `onebusaway-api-webapp`
- * `onebusaway-webapp`
-
-Start up the Tomcat instance within Eclispe and browse to:
-
-http://localhost:8080/onebusaway-webapp/
+Moved to
https://github.com/OneBusAway/onebusaway-application-modules/wiki/Dev...