From jbosstools-commits at lists.jboss.org Thu Apr 29 13:23:46 2010 Content-Type: multipart/mixed; boundary="===============5070457916526772143==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r21804 - trunk/hibernatetools/docs/reference/en-US. Date: Thu, 29 Apr 2010 13:23:46 -0400 Message-ID: <201004291723.o3THNkgP018415@svn01.web.mwc.hst.phx2.redhat.com> --===============5070457916526772143== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: smukhina Date: 2010-04-29 13:23:46 -0400 (Thu, 29 Apr 2010) New Revision: 21804 Modified: trunk/hibernatetools/docs/reference/en-US/plugins.xml Log: https://jira.jboss.org/jira/browse/TOOLSDOC-18 - New annotations support in= Hibernate platform for Dali - 4.13.3. Hibernate Annotations Support Chapte= r is updated = Modified: trunk/hibernatetools/docs/reference/en-US/plugins.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/hibernatetools/docs/reference/en-US/plugins.xml 2010-04-29 16:50:= 52 UTC (rev 21803) +++ trunk/hibernatetools/docs/reference/en-US/plugins.xml 2010-04-29 17:23:= 46 UTC (rev 21804) @@ -24,14 +24,20 @@
Download base project You can download example projects which are used for this chap= ter. - JPA base project is available on documentation resources page = together with base Java project. - Also you need start database. + JPA base project is available on documentation res= ources page + together with base Java project. + Also you need start database. Note: - How to run database you can know in Getting Started Guide. + How to run database you can know in Getting Started Guide.
- =
Creating a Hibernate Mapping File @@ -45,9 +51,9 @@ At first you'll be asked to select a package or multiple in= dividual classes to map. It's also possible to create an empty file, don't select any pa= ckages or classes and an empty .hbm will be created in the specified location - With depth control opt= ion you can define dependences depth for - choosing classes (it means to set level of references which is used = to collect linked classes - to the selection). + With depth control opt= ion you can define + dependences depth for choosing classes (it means to set level of ref= erences which is used to + collect linked classes to the selection).
Hibernate XML Mapping File Wizard @@ -56,7 +62,10 @@
- The next wizard page lists the mappings to be generated. As you = see Customers, Orders, = Productlines and Products classes added und= er depth control driving. + The next wizard page lists the mappings to be generated. As you = see Customers, Orders, Prod= uctlines and + Products classes added under depth = control + driving.
Mappings to be generated @@ -65,7 +74,6 @@
- = This wizard page outputs a generated .hbm files preview.
Preview Generated Mapping Files @@ -174,8 +182,8 @@
The following table describes the available settings on the Main - tab. The wizard can automatically detect the default v= alues for most of them if you - started the wizard with the relevant java project or resource sele= cted. + tab. The wizard can automatically detect the default v= alues for most of them if + you started the wizard with the relevant java project or resource = selected. Hibernate Console Configuration Parameters @@ -275,8 +283,8 @@ Name of the persistence unit to use - No default value (let Hibernate Entity Manager find = the persistence unit or - it can be defined manually using Browse button) + No default value (let Hibernate Entity Manager find = the persistence unit or it + can be defined manually using Browse button) @@ -284,7 +292,7 @@
Tip: - The two latter settings are usually not required if you spe= cify a project and it has + The two latter settings are usually not required if you spec= ify a project and it has /hibernate.cfg.xml @@ -340,8 +348,8 @@ Database dialect - Define a database dialect. It's possible either= to write your value or choose - from list. + Define a database dialect. It's possible either= to write your value or + choose from list. No default value @@ -540,7 +548,8 @@ right-click on the configuration in Hibernate Configurations View->Edit Configuration = - or just double-click on Console Configur= ation item. + or just double-click on Console Configur= ation + item.
Opening Edit Configuration Wizard @@ -662,8 +671,8 @@ Choose between "CORE", "ANNOTAT= IONS" and "JPA" according to the method of relatio= nal mapping you want to - use. Note, the two latter requires running Eclipse= IDE with a JDK 5 - runtime, otherwise you will get classloading and/o= r version errors. + use. Note, the two latter requires running Eclipse= IDE with a JDK 5 runtime, + otherwise you will get classloading and/or version= errors. True @@ -675,10 +684,10 @@
-
+
Closing Hibernate Console Configuration - To close Hibernate Console Configuration = you need do right-click your configuration - and choose Close Configuration option + To close Hibernate Console Configuration = you need do right-click + your configuration and choose Close Configuration option
Close Hibernate Console Configuration @@ -2450,10 +2459,11 @@ Enable debug logging in the plugins It is possible to configure the eclipse plugin to route all logg= ing made by the plugins and hibernate code it self to the Error Log View in Eclipse. - Error Log View is very useful tool to solve= any problem which appears in Hibernate Tools Plugins. = - You can use if there are troubles with setting up Hibernat= e Console Configuration. = + Error Log View is very useful tool to solve= any problem which appears + in Hibernate Tools Plugins. You can use if there are troubles with s= etting up Hibernate Console Configuration. This is done by editing the - hibernate-log4j.properties + hibernate-log4j.properties in org.hibernate.eclipse/ directory/jar . This file includes a default configuration that only lo= gs WARN and above to a set @@ -2474,187 +2484,196 @@ JPA development platform.
Creating JPA project with Hibernate support - When starting a new JPA project from - New > Other > JPA > JPA Project - (or simply - New > JPA Project - in JPA Perspective), the first wiza= rd page looks as - follows. -
- Starting JPA Project - - - - - -
- It's possible here to select a target runtime and change th= e project configuration, - or you can leave everything as it is. - On the JPA Facet page you should choose Hibernate as a target pl= atform. Also select the - proper database connection, if it is defined, or add a new one by cl= icking the - Add connection - link. - Hitting - Finish - will generate the project. -
- Targeting at Hibernate Platform - - - - - -
- - Note: - Please note, if you choose Hibernate as a platform while creat= ing a JPA/Dali project, a - Hibernate Console Configuration for the project is created automat= ically when the wizard - finishes its work. It allows a full usage of Hibernate T= ools features - without additional setup. - + When starting a new JPA project from + New > Other > JPA > JPA Project + (or simply + New > JPA Project + in JPA Perspective), the first wi= zard page looks as + follows. +
+ Starting JPA Project + + + + + +
+ It's possible here to select a target runtime and change = the project configuration, + or you can leave everything as it is. + On the JPA Facet page you should choose Hibernate as a target = platform. Also select the + proper database connection, if it is defined, or add a new one by = clicking the + Add connection + link. + Hitting + Finish + will generate the project. +
+ Targeting at Hibernate Platform + + + + + +
+ + Note: + Please note, if you choose Hibernate as a platform while cre= ating a JPA/Dali project, + a Hibernate Console Configuration for the project is created aut= omatically when the wizard + finishes its work. It allows a full usage of Hibernate= Tools features + without additional setup. +
-
= - Generating DDL and Entities - By enabling Hibernate platform specific features you can now ge= nerate DDL and Entities. - For that find - JPA Tools > Generate Tables from Entities/Generate Entit= ies from Tables - options in the context menu of your JPA project. -
- Generate DDL/Entities - - - - - -
- - Note: - Please, remember to put the proper database driver to the clas= spath of your - project. - - The Generate Entities wizard first will ask= you to choose the - directory where all output will be written. -
- Generate Entities Wizard - - - - - -
- To generate entities you can use: - - - a Hibernate Console Configuration (proposed by default) - Just make sure that the - Use Console Configuration - checkbox is selected and choose a needed configuration= from the - Console configurations - list box. -
- Generate Entities Wizard - - - - - -
- - - - - or a DTP connection directly - Just uncheck - Use Console Configuration - and adjust database settings. - - - All the same you do with Generate Entities Wizard you can do wit= h Generate DDL wizard. - Special feature for Generate DDL wizard is possible automatic execut= ion of Generation DDL in - the database. -
- Generate DDL Wizard - - - - - -
- Thus, you can now have the Hibernate runtime support in Eclipse = JPA projects. -
-
+
+ Generating DDL and Entities + By enabling Hibernate platform specific features you can now g= enerate DDL and Entities. + For that find + JPA Tools > Generate Tables from Entities/Generate Ent= ities from + Tables + options in the context menu of your JPA project. +
+ Generate DDL/Entities + + + + + +
+ + Note: + Please, remember to put the proper database driver to the cl= asspath of your + project. + + The Generate Entities wizard first will a= sk you to choose the + directory where all output will be written. +
+ Generate Entities Wizard + + + + + +
+ To generate entities you can use: + + + a Hibernate Console Configuration (proposed by default) + Just make sure that the + Use Console Configuration + checkbox is selected and choose a needed configura= tion from the + Console configurations + list box. +
+ Generate Entities Wizard + + + + + +
+ + + + + or a DTP connection directly + Just uncheck + Use Console Configuration + and adjust database settings. + + + All the same you do with Generate Entities Wizard you can do w= ith Generate DDL wizard. + Special feature for Generate DDL wizard is possible automatic exec= ution of Generation DDL in + the database. +
+ Generate DDL Wizard + + + + + +
+ Thus, you can now have the Hibernate runtime support in Eclips= e JPA projects. +
+
Hibernate Annotations Support - Also Hibernate Annotations are supported in Dali Java= Persistence Tools. - The next annotations are integrated with JPA Details view: - - = - Id Generator annotations - @GenericGenerator and @GeneratedValue -
- @GenericGenerator support in Dali - - - - = + Also Hibernate Annotations are supported in Dali Jav= a Persistence + Tools. The next annotations are integrated with JPA + Details view: + + + Id Generator annotations - @GenericGenerator and @GeneratedValue +
+ @GenericGenerator support in Dali + + + - = - -
-
- @GeneratedValue support in Dali - - - - - = - -
= - - - Property annotations- @DiscriminatorFormula, @Generated Annotation, @Index annotat= ion -
- @Index support in Dali - - - - - = - -
- = - - - Mapping Queries annotations - @NamedQuery and @NamedNativeQuery -
- Add New Named Query Dialog with Hibernate Support - - - - - = - -
- = - = - = -
- @NamedQuery support in Dali - - - - - = - -
- - - More information about Hibernate Annotation you can find in Hibernate Annotations Reference Guide. = - = -
+ +
+
+ @GeneratedValue support in Dali + + + + + +
+ + + Property annotations- @DiscriminatorFormula, @Generated Annotation, @Index annotati= on +
+ @Index support in Dali + + + + + +
+ + + Mapping Queries annotations - @NamedQuery and @NamedNativeQuery +
+ Add New Named Query Dialog with Hibernate Support</titl= e> + <mediaobject> + <imageobject> + <imagedata fileref=3D"images/plugins/dali_integration10.pn= g"/> + </imageobject> + </mediaobject> + </figure> + <figure> + <title>@NamedQuery support in Dali + + + + + +
+ + + Association annotations in an embeddable object (@OneToOne, @ManyToOne, @OneToMany or @ManyToMany)<= /para> +
+ Hibernate Support for Embeddable Object + + + + + +
+ + + More information about Hibernate Annotation you can find in Hibernate + Annotations Reference Guide. +
Relevant Resources Links - There is full information about native Dali plugin features on= Eclipse = Documentation page. = + There is full information about native Dali plugin features on= Eclip= se Documentation + page.
- =
- = --===============5070457916526772143==--