1 2 Previous Next 16 Replies Latest reply on Nov 10, 2007 4:43 AM by maxandersen

    JBoss Tools Documentation

    b1costa2

      Hi,

      Is there any documentation available for JBoss Tools 2.0.0 (not JBoss IDE)?

      Thanks.

        • 1. Re: JBoss Tools Documentation
          maxandersen

          Press F1 in eclipse ;)

          The best ones otherwise available is here http://www.redhat.com/developers/rhds/index.html

          Any specific documentation you are missing ?

          • 2. Re: JBoss Tools Documentation
            b1costa2

            Thanks for the link.

            The documents I found before were outdated. Almost all of them referred JBoss IDE instead of JBoss Tools.

            • 3. Re: JBoss Tools Documentation
              bdlink

              Still looking for JBoss Tools 2.0 documentation.

              Pressing F1 in eclipse (after installing beta 4) does not provide any documentation for Jboss tools that I can find. There is some documentation for Hibernate, some very old (3-4 years?) documentation for doing a J2EE 1.4 CMP application with XDoclet. Nothing on EJB3 that I see.

              The referenced information on the redhat site seems to be also outdated.

              Will there be tools to work with EJB3 entity beans (including reverse engineering a single table) in the context of a seam application (preferably seam 2.0 which seems to be almost out)?

              In looking around, I get the idea that there was an EJB3 tool in an earlier version which has been dropped. True/false?

              • 4. Re: JBoss Tools Documentation
                maxandersen

                we removed the old jbide doc in latest build.

                some updated docs will come out with GA, others (articles etc.) will follow later.

                "Will there be tools to work with EJB3 entity beans (including reverse engineering a single table) in the context of a seam application"

                What do you mean single table ?

                EJB3 entity beans in general is just JPA and yes that is there and have been there for almost 1.5 years ;)

                "(preferably seam 2.0 which seems to be almost out)?"

                Nightly builds supports Seam 2.

                "In looking around, I get the idea that there was an EJB3 tool in an earlier version which has been dropped. True/false?"

                Depends ;) We had an ejb3 project type in the beta that was dropped since it conflicted with the rest of the eclipse world. The ejb3 wizards are still in there.

                • 5. Re: JBoss Tools Documentation
                  hafidzmalik

                   

                  Will there be tools to work with EJB3 entity beans (including reverse engineering a single table) in the context of a seam application (preferably seam 2.0 which seems to be almost out)?


                  If I understand you correctly. Seam provide "seam generate-entities" but not providing "seam generate-entity". Alternative to that, you can always use "seam new-entity" in the latest release of Seam 2.0.0 GA. Although I have no idea on how to use it yet.

                  Hardly wait to get JBoss Tools featured Seam 2.0.

                  • 6. Re: JBoss Tools Documentation
                    maxandersen

                    We have New Entity in the tooling too yes.

                    But it doesn't reverse engineer from a db in its current form.

                    JBoss Tools does support Seam 2 now.

                    • 7. Re: JBoss Tools Documentation
                      garypinkham

                       

                      "hafidzmalik" wrote:
                      If I understand you correctly. Seam provide "seam generate-entities" but not providing "seam generate-entity". Alternative to that, you can always use "seam new-entity" in the latest release of Seam 2.0.0 GA. Although I have no idea on how to use it yet.


                      Unless this has changed in the GA release.. What I have done is create the project then edit the "seam-gen.reveng.xml" file. In this you can exclude/include specific DB tables. This will allow you to generate only one specific table...

                      Gary

                      • 8. Re: JBoss Tools Documentation
                        garypinkham

                         

                        "garypinkham" wrote:
                        Unless this has changed in the GA release.. What I have done is create the project then edit the "seam-gen.reveng.xml" file. In this you can exclude/include specific DB tables. This will allow you to generate only one specific table...


                        Of course I go to try this today with Seam 2.0GA and the JBossTools nightly build and I can't seem to figure out where the "seam-gen.reveng.xml" file goes! When creating the eclipse project using the ant scripts the file is there but when creating using the new tools inside eclipse the file doesn't exist. I created one and have tried several locations but none are recognized by the "seam generate-entities" action in eclipse. Any ideas?

                        Thanks! Gary

                        • 9. Re: JBoss Tools Documentation
                          maxandersen

                          the tooling doesn't create the reveng.xml file yet.

                          But you can just go to Run>Hibernate Code Generation and edit the generate entities configuration and in here you can point to a reveng.xml

                          • 10. Re: JBoss Tools Documentation
                            garypinkham

                             

                            "max.andersen@jboss.com" wrote:
                            the tooling doesn't create the reveng.xml file yet.

                            But you can just go to Run>Hibernate Code Generation and edit the generate entities configuration and in here you can point to a reveng.xml


                            Thanks! That did the trick.
                            Gary

                            • 11. Re: JBoss Tools Documentation
                              bdlink

                              After reading from Max (above) that we are to use Dali for persistence with JBoss tools, I tried using JPA with todays Jboss tools nightly build, after creating a seam-web project (with Seam 2). As near as I can figure, JPA only works in a JPA project. It does not appear to work with a Seam project with JPA aspect added (in the JPA structure window the message "Structure is not available for the current selection" when selecting a class which is to be bound to a database table). The Dali tutorial works but requires a JPA project.

                              The last messages sound like we should be using hibernate directly for generating Entities from DB tables.

                              Using a seam entity does not seem to do anything useful, because the associated pages get out of synch when you edit the entity properties. Perhaps more useful would be generating the other artifacts (Home, List, and pages) after the Entity has been generated.

                              Using seam-gen does not seem to work well, because it is all database tables or nothing, and gets the relationships wrong (not enough info in database schema to determine correct multiplicities and direction). After correcting the Entities you have to track down corrections in the other artifacts, since refactoring does not know about the dependencies.

                              I noticed that the example JBoss tools documentation does not yet get past the front end to generating the entities.

                              I am assuming/hoping that my confusion is simply due to a lack of documentation which will eventually be answered (or perhaps features which are not there but will be for GA), but I am still trying to figure the best way to do a simple application with a database that has multiple tables, with relationships. I am trying to use JSF/Facelets/RichFaces/Seam2/EJB3/JAS4.2.2.

                              Pointers to an end-to-end project would be useful (something more than a one-table CRUD example). If seam is the main focus of JBoss tools/RHDS, perhaps the examples in the Seam tutorial could be redone using these tools.

                              When JBoss Tools/RHDS really gets it together, it looks like it will be preferable to the NetBeans model which has the same architectural constraints that Sun Studio Creator had (each page has a backing bean that everything gets dumped into, etc.)

                              • 12. Re: JBoss Tools Documentation
                                maxandersen

                                 

                                "bdlink" wrote:
                                After reading from Max (above) that we are to use Dali for persistence with JBoss tools


                                I did not say you have to - I just say it was an option.
                                We don't enable Dali by default because there are issues with Dali's default behavior (e.g. not knowing what the right default schema on dbs)


                                I tried using JPA with todays Jboss tools nightly build, after creating a seam-web project (with Seam 2). As near as I can figure, JPA only works in a JPA project. It does not appear to work with a Seam project with JPA aspect added (in the JPA structure window the message "Structure is not available for the current selection" when selecting a class which is to be bound to a database table). The Dali tutorial works but requires a JPA project.


                                Yes - so you need to enable the JPA facet. Can be done at creation time in the wizard or right click on the project and add the facet under the facet preferences.


                                The last messages sound like we should be using hibernate directly for generating Entities from DB tables.


                                I don't understand ? Just use Seam Generate Entities...(which will setup the proper Hibernate tools setup)


                                Using a seam entity does not seem to do anything useful, because the associated pages get out of synch when you edit the entity properties.


                                Yes - welcome to the land of codegeneration...


                                Perhaps more useful would be generating the other artifacts (Home, List, and pages) after the Entity has been generated.


                                So use Seam Generate Entities Wizard, but select "Use existing entities" instead of the "Reverse engineer from database"


                                Using seam-gen does not seem to work well, because it is all database tables or nothing, and gets the relationships wrong (not enough info in database schema to determine correct multiplicities and direction).


                                Yes - depending on what things you want to configure you can decide to use a .reveng.xml file to control these things very precise.

                                Over time we will make this more easily available. See Hibernate tools for the docs about these things.


                                After correcting the Entities you have to track down corrections in the other artifacts, since refactoring does not know about the dependencies.


                                try generating from the enttiies instead...


                                I noticed that the example JBoss tools documentation does not yet get past the front end to generating the entities.


                                Which example exactly ?


                                I am assuming/hoping that my confusion is simply due to a lack of documentation which will eventually be answered (or perhaps features which are not there but will be for GA), but I am still trying to figure the best way to do a simple application with a database that has multiple tables, with relationships.


                                Use Seam Generate Entities - but it is only something that generates the *basis* of an app.


                                I am trying to use JSF/Facelets/RichFaces/Seam2/EJB3/JAS4.2.2.


                                this is what the seam-gen/Wizards are targeted at.


                                Pointers to an end-to-end project would be useful (something more than a one-table CRUD example). If seam is the main focus of JBoss tools/RHDS, perhaps the examples in the Seam tutorial could be redone using these tools.


                                I don't recall any multi table examples in seam tutorial ? link ?


                                When JBoss Tools/RHDS really gets it together, it looks like it will be preferable to the NetBeans model which has the same architectural constraints that Sun Studio Creator had (each page has a backing bean that everything gets dumped into, etc.)


                                Yes - that is definitly not the way our tooling works - we belive in less constraints (but that also put some more responsiblity on to the programmer ;)



                                • 13. Re: JBoss Tools Documentation
                                  bdlink

                                  Thank you for your prompt reply.

                                  I selected the JPA facet when creating the project. However looking at the project facets for the -ejb project, it does not show up. Adding in the JPA facet at that point does fix the Dali error.

                                  I did not (in this test project) use seam generate enties, because I have used it before, and it has issues which I mentioned in my post. I have not yet tried controlling it with reveng.xml (next step )

                                  I tried using Seam generate entities from entity and got the following error: can't generate seam entities, with details regarding not being able to load JPA configuration (illegal characters in path - perhaps the space in "Documents and Settings" - where the eclipse workspace is).


                                  I was referring to example Getting Started with Redhat Studio at: http://www.redhat.com/developers/rhds/pdf/Getting_Started_with_RHDS.pdf


                                  Most of the examples in the Seam tutorial are multiple table examples ( Hotel booking example, DVD store)

                                  Anyway, I can try some other things now, thanks for the help!

                                  • 14. Re: JBoss Tools Documentation
                                    maxandersen

                                    Ah yes - the page in the seam wizard only enables it for the war...(after GA we will create a better way of setting up these projects - facet's are only meant for "single style" projects)

                                    The space issue is caused by hiberante entitymanager not being able to scan classpaths' with spaces in it...that is fixed in the latest builds though.

                                    Ah yes the full example apps examples are multitable - but you wouldn't build those with Generate Entities.....at least not the "technical parts"

                                    but yees - we should get a more complete tutorial in there.

                                    1 2 Previous Next