[JAVAEETUTORIAL-279] Chapter 23 Coding the Enterprise Bean Class Created: 12/Jul/14  Updated: 23/Jul/14  Resolved: 23/Jul/14

Status: Closed
Project: javaeetutorial
Component/s: examples
Affects Version/s: None
Fix Version/s: 7.0.4

Type: Bug Priority: Minor
Reporter: shapir Assignee: super_glassfish
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

The @WebSerlet code snippet declares
@EJB
ConverterBean converterBean

but later on uses variable converter- which is not declared -, rather than converterBean:
BigDecimal yenAmount = converter.dollarToYen(d);

// call the ConverterBean.yenToEuro() method to get the amount
// in Euros
BigDecimal euroAmount = converter.yenToEuro(yenAmount);



 Comments   
Comment by jendrock [ 23/Jul/14 ]

This issue is logged against the Java EE 6 Tutorial. We recommend that you use the Java EE 7 Tutorial, in which the problem that you identified has been fixed. See http://docs.oracle.com/javaee/7/tutorial/doc/ejb-gettingstarted001.htm#GIPSI. In the corresponding section, the @WebServlet code snippet now declares:

@EJB
ConverterBean converter;

then later uses the variable converter, which now has been declared.

// call the ConverterBean.dollarToYen() method to get the amount
// in Yen
BigDecimal yenAmount = converter.dollarToYen(d);

// call the ConverterBean.yenToEuro() method to get the amount
// in Euros
BigDecimal euroAmount = converter.yenToEuro(yenAmount);

The Java EE 7 Tutorial is actively maintained; we correct all errors promptly in that version. We will make every effort to suppress the Java EE 6 and Java EE 5 tutorial entries in the search engine results so this problem is minimized in the future.

Comment by jendrock [ 23/Jul/14 ]

The content is correct in the Java EE 7 Tutorial. See http://docs.oracle.com/javaee/7/tutorial/doc/ejb-gettingstarted001.htm#GIPSI.





[JAVAEETUTORIAL-272] dukeetf : add clarification on how to run the sample Created: 23/Jun/14  Updated: 24/Jun/14  Resolved: 24/Jun/14

Status: Closed
Project: javaeetutorial
Component/s: doc
Affects Version/s: 7.0.3
Fix Version/s: 7.0.4

Type: Improvement Priority: Trivial
Reporter: David Delabassee Assignee: jendrock
Resolution: Won't Fix Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

Not relevant



 Description   

I suggest to add a remark that the url to invoke the sample (17.17.2) should use localhost and only localhost as this is hardcoded in the sample.
Eg. if one try to launch the sample from the GF Admin, it will not work because the actual hostname will be used and the browser will block JS request to localist as it's a different domain



 Comments   
Comment by jendrock [ 24/Jun/14 ]

Since the tutorial promotes 2 ways of deploying and running the examples, neither of which involves the Admin Console, I am going to leave well enough alone in this case and not change the existing text or add any caveats. In a true production environment, the server name and port number would be generated dynamically, not hardcoded as they are in the example. Adding that functionality would be overkill here.

There is a simple solution, however. Replace this line in main.xhtml:

ajaxRequest.open("GET", "http://localhost:8080/dukeetf/dukeetf", true);

With this line:

ajaxRequest.open("GET", "/dukeetf/dukeetf", true);

It will work all three ways (deploy in NetBeans, using mvn install, and using Admin Console). I just don't want to document that. Just know that it works.





[JAVAEETUTORIAL-261] dukes-boookstore example, wrong description in bookdetails.html Created: 11/Feb/14  Updated: 11/Feb/14  Resolved: 11/Feb/14

Status: Closed
Project: javaeetutorial
Component/s: examples
Affects Version/s: 7.0.3
Fix Version/s: 7.0.4

Type: Bug Priority: Trivial
Reporter: dejf.mountain Assignee: Kim Haase
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

Comment in <h:form> in bookdetails.html should be

<!-- Retrieve the "selected" value placed in the session map by the
CatalogBean.details method. -->

instead of

<!-- Retrieve the "selected" value placed in the session map by the
BookstoreBean.details method. -->



 Comments   
Comment by Kim Haase [ 11/Feb/14 ]

Thanks for your attention to detail! In fact that value is placed in the map by both the BookstoreBean and the CatalogBean, so that the details can be retrieved from either page. We will add that information.

Comment by Kim Haase [ 11/Feb/14 ]

Committed fix at revision 1734.

Comment by Kim Haase [ 11/Feb/14 ]

Fixed in source, will appear in next release.





[JAVAEETUTORIAL-260] Wrong CriteriaQuery.join() examples in the Criteria API documentation Created: 30/Jan/14  Updated: 30/Jan/14  Resolved: 30/Jan/14

Status: Closed
Project: javaeetutorial
Component/s: doc
Affects Version/s: 7.0.2
Fix Version/s: 7.0.4

Type: Bug Priority: Major
Reporter: patrik.varga Assignee: Kim Haase
Resolution: Fixed Votes: 1
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Tags: CriteriaQuery, criteria, join

 Description   

There are some examples of CriteriaQuery.join() calls in the Criteria API documentation.
Neither CriteriaQuery nor its superinterface AbstractQuery have a join() method.
These local variables should refer to the root node "pet" instead of the CriteriaQuery "cq".

Occurences in "Using the Criteria API and Metamodel API to Create Basic Typesafe Queries":

"Querying Relationships Using Joins":
Join<Owner, Address> address = cq.join(Pet_.owners).join(Owner_.addresses);

"Ordering Results":
Join<Owner, Address> address = cq.join(Pet_.owners).join(Owner_.address);
Join<Pet, Owner> owner = cq.join(Pet_.owners);



 Comments   
Comment by Kim Haase [ 30/Jan/14 ]

Thank you very much for pointing out these errors. The fixes will appear in the next Tutorial update.

We appreciate your interest in the Tutorial.

Comment by Kim Haase [ 30/Jan/14 ]

Fixed in documentation source.





[JAVAEETUTORIAL-259] Tutorial uses nonexisting command: asadmin command create-resources Created: 28/Jan/14  Updated: 28/Jan/14  Resolved: 28/Jan/14

Status: Closed
Project: javaeetutorial
Component/s: doc
Affects Version/s: 7.0.2
Fix Version/s: 7.0.4

Type: Bug Priority: Major
Reporter: geirot Assignee: Kim Haase
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

Totorial Java EE 7 chapter 3.3 Creating Resources Administratively
uses: asadmin create-resources glassfish-resources.xml
this command doesn't exist
should use: asadmin add-resources glassfish-resources.xml



 Comments   
Comment by Kim Haase [ 28/Jan/14 ]

Thank you very much for pointing out this error.

Comment by Kim Haase [ 28/Jan/14 ]

Fixed in FrameMaker source.





[JAVAEETUTORIAL-253] Update EL chapter to reflect 3.0 changes Created: 27/Sep/13  Updated: 11/Feb/14  Resolved: 11/Feb/14

Status: Closed
Project: javaeetutorial
Component/s: doc
Affects Version/s: 7.0.2
Fix Version/s: 7.0.4

Type: Bug Priority: Major
Reporter: Kim Haase Assignee: Kim Haase
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

The Expression Language chapter includes some new features of EL 3.0, but still contains some obsolete language. I have committed some changes based on a first review, but there may be more to come.



 Comments   
Comment by Kim Haase [ 11/Feb/14 ]

Fixes completed.





[JAVAEETUTORIAL-252] Incorrect instructions for Section 29.3.1, Creating A Simple RESTful Web Service Created: 27/Sep/13  Updated: 27/Sep/13  Resolved: 27/Sep/13

Status: Resolved
Project: javaeetutorial
Component/s: doc
Affects Version/s: 7.0.3
Fix Version/s: 7.0.4

Type: Bug Priority: Minor
Reporter: jendrock Assignee: Ian Evans
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

There are several issues that need to be address with regard to the documentation surrounding the simplest of the 3 JAX-RS examples.

The sentence that precedes 29.3.1.1 needs to be modified to say something to the effect that the prebuilt example is similar but not identical to the example that one can build from the archetype. There should also be links to new sections for running that prebuilt example with NetBeans IDE and Maven from the command line.

There needs to be a step 0 that says "Ensure that you have installed the tutorial archetypes as described in Section 2.7.1, Installing the Tutorial Archetypes.

Step 1d needs to be changed from "... and click Next." to "... and click Finish."

Step 1e needs to be deleted.

In step 2, delete "and the exception".

In step 2, move the Note so that it follows the code example.

In step 3, change "hello project" to "HelloWorldApplication project" and change "Build" to "Run".

In step 4, change the URL from "http://localhost:8080/hello" to "http://localhost:8080/HelloWorldApplication/HelloWorldApplication".

Add a new section - 29.3.1.2, To Run the hello Example with NetBeans IDE.

Add a new section - 29.3.1.3, To Run the hello Example with Maven.

Make sure the instructions match the prebuilt example. For example, the URL to open would be http://localhost:8080/hello/helloworld.



 Comments   
Comment by Ian Evans [ 27/Sep/13 ]

There is no need for separate "To Run the Example..." sub-sections because this step-by-step is only for NetBeans users. We don't document how to create new examples based on the archetypes on the command-line, although it is definitely possible to do so.

Comment by Ian Evans [ 27/Sep/13 ]

Fixed the instructions, except for the new sub-sections on running in NetBeans/with Maven.

Comment by jendrock [ 27/Sep/13 ]

So, the jaxrs/hello example that is is the workspace serves what purpose? Is it supposed to be run? If so, how? I just thought that if we provide an example, especially one that is different from the one that is built from the archetype, we would also have instructions for running it. In fact, that is how the whole issue came about. I was asked if we had a very simple JAX-RS example. I said we did. And then I was asked for directions for running it from the command line. That we did not have.

Comment by Ian Evans [ 27/Sep/13 ]

We've never had separate sections on running the pre-built example we documented in our step-by-step instructions before. The assumption has always been that the pre-built version is more of a reference for a working version of what you end up with rather than an example that is documented separately.

I'm fine putting in two new sections on running hello, but this is somewhat different than our previous practices.

Comment by jendrock [ 27/Sep/13 ]

I think this is the only example in the tutorial that users actually create. First Cup does the same thing but the example that is supplied matches (exactly) the example that users end up with after they follow the step-by-step instructions. The JAX-RS hello example is close, but definitely not identical to the resultant example users will build in this case. This is a different animal than we are used to.

I am surprised that no users have asked how to run hello, either by using Maven or NetBeans IDE. If hello matched the end result that the users built, no NB instructions would be needed. Would they ask how to run with Maven? Not to use Maven to build the example from the archetype but to run the prebuilt example.

Maybe I'm all wet. Maybe what is needed is to make the examples the same and simply say that the example is provided as a reference, as you said.





[JAVAEETUTORIAL-251] Parts after 3 are incorrectly numbered Created: 23/Sep/13  Updated: 23/Sep/13  Resolved: 23/Sep/13

Status: Resolved
Project: javaeetutorial
Component/s: None
Affects Version/s: None
Fix Version/s: 7.0.4

Type: Bug Priority: Minor
Reporter: Kim Haase Assignee: Kim Haase
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

After Part IV, Bean Validation, all the other parts have incorrect numbers in the text, though their titles are correct. Part IV doesn't actually say "Part IV" on it.



 Comments   
Comment by Kim Haase [ 23/Sep/13 ]

Renumbered parts.





[JAVAEETUTORIAL-248] Insufficient spacing between paragraphs inside a list item in HTML Created: 20/Sep/13  Updated: 25/Mar/14  Resolved: 25/Mar/14

Status: Closed
Project: javaeetutorial
Component/s: None
Affects Version/s: 7.0.2
Fix Version/s: 7.0.4

Type: Bug Priority: Trivial
Reporter: rcervera Assignee: Unassigned
Resolution: Won't Fix Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

See the paragraphs inside the list items in 53.1.1:
http://docs.oracle.com/javaee/7/tutorial/doc/batch-processing001.htm



 Comments   
Comment by Kim Haase [ 25/Mar/14 ]

Spacing inside lists is not great, but we can't easily modify the current templates.





[JAVAEETUTORIAL-247] Shrub is the only viewable/editable product in the admin interface Created: 19/Sep/13  Updated: 19/Sep/13  Resolved: 19/Sep/13

Status: Resolved
Project: javaeetutorial
Component/s: examples
Affects Version/s: None
Fix Version/s: 7.0.4

Type: Bug Priority: Minor
Reporter: Kim Haase Assignee: Unassigned
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

After logging in as admin, click List of Products. Then try to view or edit any product other than the first one (Shrub).

Clicking on any other product (rosebush, green tea, etc.) always brings up the entry for Shrub.

Ian asks, "Is ProductManager not retrieving the correct row index?"



 Comments   
Comment by rcervera [ 19/Sep/13 ]

This issue is now fixed in the source.





[JAVAEETUTORIAL-242] Section of Ajax chapter belongs elsewhere Created: 05/Sep/13  Updated: 05/Sep/13  Resolved: 05/Sep/13

Status: Closed
Project: javaeetutorial
Component/s: doc
Affects Version/s: 7.0.2
Fix Version/s: 7.0.4

Type: Bug Priority: Minor
Reporter: Kim Haase Assignee: Kim Haase
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

The section "Partial Processing and Partial Rendering" in the Ajax chapter really belongs in the chapter that contains the lifecycle information. I am moving it to a level 1 section after "The Lifecycle of a JavaServer Faces Application." I fixed the chapter jumplists too. I cannot find any broken xrefs that I haven't fixed, but that doesn't mean there aren't any.



 Comments   
Comment by Kim Haase [ 05/Sep/13 ]

Committed fix.





[JAVAEETUTORIAL-189] Use rich formatting with multi colors fonts and styles Created: 13/Jun/13  Updated: 26/Mar/14  Resolved: 25/Mar/14

Status: Closed
Project: javaeetutorial
Component/s: doc
Affects Version/s: 7.0.1
Fix Version/s: 7.0.4

Type: New Feature Priority: Minor
Reporter: miss_duke Assignee: Ian Evans
Resolution: Won't Fix Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Tags: format, readability, style

 Description   

Java tutorial now uses limited colors and fonts. For example Java code snippets in the tutorial remains in plain black.

Code snippets may be formatted as they are displayed in an IDE editor. Various colors fonts and styles may be used wherever possible in the tutorial text.

This needs some effort but this will tremendously increase the readability of the tutorial.

I can point Android tutorials as an example for good presentation:
http://developer.android.com/guide/components/activities.html



 Comments   
Comment by Ian Evans [ 24/Jun/13 ]

We're working on finding a solution that will work with our tools. We'll update this issue as we make progress.

Comment by Ian Evans [ 19/Sep/13 ]

Lowering the priority and deferring to the next release. Our tools team does not have a solution for us at this time.

Comment by Kim Haase [ 25/Mar/14 ]

There is no plan for our tools to implement this feature. Colors used for syntactic purposes impede the accessibility of the documentation.

Comment by miss_duke [ 26/Mar/14 ]

"...Colors used for syntactic purposes impede the accessibility of the documentation..."

Colors used in Git, Android, AngularJS websites are all impede accessibility?! (If you have no resource or skill set please admit it, do not say stupid reasons)

Comment by Kim Haase [ 26/Mar/14 ]

1) Oracle focuses very strongly on accessibility issues, more than most companies.

2) Our tools team will not devote resources to features that might impede accessibility.





[JAVAEETUTORIAL-67] Provide an ePub, single-page html or other easily convertable format Created: 14/Mar/12  Updated: 05/Mar/14  Resolved: 05/Mar/14

Status: Resolved
Project: javaeetutorial
Component/s: doc
Affects Version/s: 6.0.7-5
Fix Version/s: 7.0.4

Type: Improvement Priority: Minor
Reporter: 8086 Assignee: jendrock
Resolution: Won't Fix Votes: 1
Labels: None
Remaining Estimate: 3 hours
Time Spent: Not Specified
Original Estimate: 3 hours


 Description   

In this day and age, an increasing amount of people are reading technical literature on their ebookreaders (like Kindle or Nook), smartphones (iPhone, Android) or tablets. PDF, although great for printing, is not really suited for these formats (fixed layout, pagination, A4/US-letter, etc). These devices support a wide variety of formats like RTF, ePub, HTML or pure text, and often the easy way is to convert the pdf into one of these format.

This route has varying degrees of success (OCR, page breaks, ... lots of obstacles), and in this case, most software that I have tried (including Calibre) fails to convert this pdf into any format (parsing failures). Therefore it would make sense to provide another format in addition to pdf that is more easily read on electronic reading devices without a fixed format.

A simple solution could be just a single-page, downloadable html file (zipped with images and stylesheets). This would be the least amount of work and easily convertable to other forms. An ePub would also be nice (read on most ebookreaders, all Android devices, and easy to convert to Mobi format for Kindle).



 Comments   
Comment by Ian Evans [ 15/Aug/12 ]

We're at the mercy of our internal authoring and publication tools here. But my understanding is that we might have this capability for the Java EE 7 release.

Comment by jendrock [ 04/Jan/13 ]

We will not be fixing this issue for the Java EE 6 Tutorial. We plan on providing both ePub and Mobi format files for the Java EE 7 Tutorial.

In the meantime, the first volume of the tutorial (The Java EE 6 Tutorial: Basic Concepts) is available in Kindle format. See http://www.amazon.com/The-Java-EE-Tutorial-ebook/dp/B004323DTG/ref=sr_1_4?ie=UTF8&qid=1357337093&sr=8-4&keywords=java+ee+6+tutorial.

The second volume (The Java EE 6 Tutorial: Advanced Topics) is due to be released on January 20, 2013. A Kindle version will likely be released in that timeframe as well. See http://www.amazon.com/The-Java-EE-Tutorial-Advanced/dp/0137081863/ref=sr_1_2?ie=UTF8&qid=1357337093&sr=8-2&keywords=java+ee+6+tutorial.

Comment by Ian Evans [ 24/Jun/13 ]

Reopening for Java EE 7.

We are still at the mercy of our publishing tools, but our tools will support ePub formats in a future release of the Java EE 7 Tutorial.

Comment by jendrock [ 05/Mar/14 ]

Earlier, we indicated that Mobi and ePub formats of the tutorial would be available as soon as we switched production systems. Due to changing circumstances, that will not occur going forward. However, the tutorial will be published as a 2-volume set by Pearson Education and, we have been assured, will be available for purchase in print as well as in Mobi and ePub formats.

Here are the links to the prepublication pages for both volumes of the Java EE 7 Tutorial on amazon.com. Be sure to click the link on the right side of the page to have Amazon tell our publisher that you want to see the electronic version of the volume made available (even though we have been assured that that will be the case).

For Volume 1, see:

http://www.amazon.com/The-Java-EE-Tutorial-Edition/dp/0321994922/ref=pd_sim_sbs_b_1?ie=UTF8&refRID=140GAT6H8ZRJFTFERGR7

For Volume 2, see:

http://www.amazon.com/The-Java-EE-Tutorial-Edition/dp/0321980085/ref=pd_sim_sbs_b_1?ie=UTF8&refRID=0FP0CHGC662997762GDX





Generated at Tue Aug 04 11:52:09 UTC 2015 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.