Overview / CRX 2.3 Documentation / 

First Steps in CRX

This page provides information about the latest CRX release in a nutshell. It is mostly intended for web developers and IT professionals, who would like to understand the basic product capabilities quickly.

You will only need minutes to get a good grasp of what CRX can do for you.

Step One: Watch Web Development with CRX Screencast

Watch the 15-minute Web Development with CRX Screencast on www.day.com.

The screencast walks you through the main product modules, while presenting our "CRX Bookstore" example application, which is an open source application presenting the main aspects of web application development on CRX platform.

The screencast has the following parts:

  • Developing with CRXDE Lite
  • Using Subversion (SVN) Integration
  • Understanding CQ5 Platform: RESTful, resource-oriented architecture of CRX's application platform based on Apache Sling
  • Understanding runtime application framework, running OSGi Service Framework based on Apache Felix
  • Understanding how CRX Bookstore application is built and how it can be extended
  • How to store content in the repository
  • Accessing data from desktop (WebDAV)
  • Understanding deployment: working with Content Packages

Step Two: Check out CRX Bookstore Example

Now check out the CRX Bookstore sample project yourself - literally!

Follow the screencast to export the project code and initial content from the CRX Bookstore project's svn server to your CRX.

In CRXDE Lite - the Develop button on the welcome screen - log in as administrator (admin/admin), go to Team > Checkout, and check out the following two projects into CRX:

  • Application will get installed into /apps/bookstore
    • URL: crxzon.googlecode.com/svn/trunk/apps/bookstore/
    • Path: /apps/bookstore
    • Click OK and wait for the console to show the summary of the operation
  • Initial / sample data will get installed into /products
    • URL: crxzon.googlecode.com/svn/trunk/products/
    • Path: /products
    • Click OK and wait for the console to show the summary of the operation

You can also use Svn Export command (Team > Export) to do the same if you do not need a SVN working copy in your repository.

Now, the only thing to have the running CRX Bookstore is to compile its executable library:

  • Go to /apps/bookstore/src/impl/com.day.crx.sample.bookshop.bnd - this is the OSGi bundle definition for our library
  • Use Tools > Build Bundle to build and deploy the code.

You are done with the development. Now, go to /products.html to see the running bookstore application.

  • localhost:7402/products.html

Your sample application is up and running. Explore its functionality - it is just a sample, but it offers all the major functionalities of an online store.

Next, go back to CRXDE Lite and discover, how the application is build.

Finally, you might try to change or extend the application slightly. There's no better way to learn than to try things out yourself. And if you an interesting enhancement, new feature, or idea, feel free to contact CRX Bookstore project team to discuss how you could contribute this to the project. Or, if you are a project committer - just Checkin your changes from CRXDE Lite.

Next Steps: Discover the Product

At this point, you should have a pretty good practical understanding of major technologies and how they work together in the product.

Next steps that we recommend are the following.

  • Use the product more, and discover its other features. Some prefer to do it by just clicking and trying things out. Try the "Learn More" link on the Welcome Screen, it has a few more simple example applications to check out to see how things work.
  • Or you could check the product documentation, we have some good introductory information there.
  • There is also a longer, more detailed Getting Started for Developers guide, with more information about technologies, and a detailed step-by-step example of how to create a simple blog application
  • Check out our Developer Portal, with blog, discussion groups, and a lot of interesting and fresh information

We hope you liked the product! Let us know your comment below on this page.


Your comments are welcome.
Did you notice a way we could improve the documentation on this page? Is something unclear or insufficiently explained? Please leave your comments below and we will make the appropriate changes. Comments that have been addressed, by improving the documentation accordingly, will then be removed.

COMMENTS

  • By Javier - 9:53 AM on May 02, 2011   Reply
    I'm sorry but this example doen't work properly
    • By aheimoz - 9:59 AM on May 02, 2011   Reply
      Could you help us and give us some more information about which specific area of the example doesn't work for you?

      Thanks.
    • By Imran Padshah - 6:32 PM on Jun 06, 2011   Reply
      Javier,
      Not sure what issues you were getting but here is what I am facing.
      1) After checking out the code and data I dont see it in a folder structure as shown in the screen shots. For example I dont have a bookstore folder under apps but folder structure like /apps/src/impl...
      2) When I try to build I get the following 3 errors:
      The method listChildren() is undefined for the type Resource. /apps/src/impl/src/main/java/com/day/crx/sample/bookstore/Account.java (line 46)
      The method listChildren() is undefined for the type Resource. /apps/src/impl/src/main/java/com/day/crx/sample/bookstore/Order.java (line 91)
      le cannot be resolved. /apps/src/impl/src/main/java/com/day/crx/sample/impl/RankingServiceImpl.java (line 140)

      Thanks
      Imran
      • By Murthy - 4:35 PM on Jun 13, 2011   Reply
        when i click on build bundle its giving the following errors:

        1)Description Resource Path Location Type
        le cannot be resolved RankingServiceImpl.java /localhost_6001/WebContent/apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl line 140 Remote Compile Problem

        2)LoginException cannot be resolved to a type RankingServiceImpl.java /localhost_6001/WebContent/apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl line 138 Remote Compile Problem

        3)resourceResolverFactory cannot be resolved or is not a field RankingServiceImpl.java /localhost_6001/WebContent/apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl line 129 Remote Compile Problem

        4)ResourceResolverFactory cannot be resolved to a type RankingServiceImpl.java /localhost_6001/WebContent/apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl line 81 Remote Compile Problem

        5)The import org.apache.sling.api.resource.LoginException cannot be resolved RankingServiceImpl.java /localhost_6001/WebContent/apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl line 35 Remote Compile Problem

        6)The import org.apache.sling.api.resource.ResourceResolverFactory cannot be resolved RankingServiceImpl.java /localhost_6001/WebContent/apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl line 38 Remote Compile Problem

        7)The method getName() is undefined for the type Resource Order.java /localhost_6001/WebContent/apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore line 88 Remote Compile Problem

        8)The method listChildren() is undefined for the type Resource Account.java /localhost_6001/WebContent/apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore line 46 Remote Compile Problem

        9)The method listChildren() is undefined for the type Resource Order.java /localhost_6001/WebContent/apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore line 91 Remote Compile Problem

        Can any one help me...
        • By adolfo - 10:30 PM on Jun 15, 2011   Reply
          I try to build and its giving the following warnings ?


          The type JcrResourceResolverFactory is deprecated
          /apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl/RankingServiceImpl.java
          79
          3045
          The method getResourceResolver(Session) from the type JcrResourceResolverFactory is deprecated
          /apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl/RankingServiceImpl.java
          127
          4682
          The field Query.XPATH is deprecated
          /apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl/RankingServiceImpl.java
          248
          10615
          The field Query.XPATH is deprecated
          /apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/impl/RankingServiceImpl.java
          271
          11591
          The method getName(Resource) from the type ResourceUtil is deprecated
          /apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/Order.java
          88
          2802
          The method listChildren(Resource) from the type ResourceUtil is deprecated
          /apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/Order.java
          91
          3053
          The method listChildren(Resource) from the type ResourceUtil is deprecated
          /apps/bookstore/src/impl/src/main/java/com/day/crx/sample/bookstore/Account.java
          47
          1834
          • By aheimoz - 9:29 AM on Aug 02, 2011   Reply
            Can you confirm which version(s) you are using?

            Also are you using the bookstore example package?

            According to the naming/filing in package share, the bookstore example was designed for CRX 2.1.0.
        • By Mv - 7:03 AM on Jun 19, 2011   Reply
          Checkout of products from crxde lite was timing out. I used eclipse crxde for checking out products.
          • By Hilbert - 12:23 AM on Jan 15, 2012   Reply
            Hello.

            I can't import bookstore example. I'm in Chrome (16.0.912.75 m) on Vista 64-bit.

            Console Output upon trying to do import:

            IMPORT /apps/bookstore (2012-01-14 18:11:08)

            svn: MKACTIVITY of '/svn/!svn/act/c31d7dde-3401-0010-8fd9-9ff16f3d1a28': 405 Method Not Allowed (crxzon.googlecode.com) svn: MKACTIVITY request failed on '/svn/!svn/act/c31d7dde-3401-0010-8fd9-9ff16f3d1a28'

            Thanks!
            • By Anonymous - 12:25 AM on Jan 15, 2012   Reply
              Oh sorry - and Java 1.6.0_24-b07, 64-bit.
              • By alvawb - 3:33 AM on Jan 24, 2012   Reply
                Unfortunately Chrome is not a supported platform for CQ 5.4. It will be supported for 5.5. See dev.day.com/docs/en/cq/current/deploying/technical_requirements.html for 5.4 supported platforms.
            • By Andy Shreve - 7:04 PM on Apr 05, 2012   Reply
              This page has several typos: Silng, wiht, commiter, and "Explore it's functionality."
              • By jkautzma - 3:56 PM on Apr 10, 2012   Reply
                Hi, thx for your feedback. We corrected the typos.
              • By smixe - 6:20 PM on Apr 25, 2012   Reply
                nice example .. my first CRDX App is running :)

                ADD A COMMENT

                 

                In order to post a comment, you need to sign-in.

                Note: Customers with DayCare user accounts need to create a new account for use on day.com.

                ***
                Tweet
                On this page:
                - Step One: Watch Web Development with CRX Screencast
                - Step Two: Check out CRX Bookstore Example
                - Next Steps: Discover the Product
                Jump to Page Comments
                gipoco.com is neither affiliated with the authors of this page nor responsible for its contents. This is a safe-cache copy of the original web site.