Eclipse Authors: Pat Romanski, Elizabeth White, Liz McMillan, David H Deans, JP Morgenthal

Related Topics: Java IoT, Open Source Cloud, Recurring Revenue

Java IoT: Article

Browsing Database Artifacts Using Data Source Explorer

Developing a Master-Detail View – Part 2

In Part 1 of this tutorial, I showed how to set up a web project and connect to a database.

In this step, you will use the Data Source Explorer to browse database artifacts. You may need to re-open the JPA perspective.

  1. In the Data Source Explorer, expand the nodes inside the New Oracle Database Connection node. You can view the individual tables and columns. Observe that the Data Source Explorer denotes which columns have been designated as primary keys. Note that the tables shown below are stored in the JPATUTORIAL schema.

  1. While browsing database artifacts, simply expand the tree to view columns, constraints, dependencies, indexes, triggers, and other relevant properties of the selected component.

  1. While browsing database artifacts, navigate up the tree to view columns, constraints, dependencies, indexes, triggers, and other relevant properties of the selected component.

  1. You can generate a DDL as well as view, print, and export an image for an E/R diagram by right clicking on the schema. For now, choose Show in Schema Viewer to see the E/R diagram.

  1. Rollover tables and the tool tips will show you summary information about the object at which you are pointing.

Make the Web Page Editor the default editor for JSP pages
The JSF Tools Project-contributed Web Page Editor (WPE) is not registered as the default editor for JSP files. You can make the WPE the default editor for JSP files by following these steps:

  • Navigate to Window -> Preferences...> General > Editors> File Associations
  • In the File types section, select "*.jsp"
  • In the Associated editors section, select Web Page Editor
  • Select the Default button

Step 2. Generate Object Relational Mappings and Test with EJBQL
Time to complete this step: 15 minutes
Oracle Enterprise Pack for Eclipse provides a powerful and flexible object relational mapping interface for popular persistence services like EclipseLink. Depending on the development scenario, object relational (O/R) mappings can be generated via different mechanisms, including reverse engineering the schema to create O/R mappings, and generating mappings from an object model.

The tasks you will complete in this step are:

Generate annotated POJOs from a schema using the JPA ORM Generation Wizard
In this step, you will use Oracle Enterprise Pack for Eclipse to automatically generate JPA entity beans from an existing database schema by reverse engineering the schema. Oracle Enterprise Pack for Eclipse will generate Java classes with the appropriate accessors and JPA annotations.

  1. Open the JPA perspective if it's not already open: Window > Open Perspective > other > JPA
  2. In the Project Explorer, right-click the project oepe-jpa-tutorial and select JPA > Generate Entities from Tables...

  1. Select the database tables from the Generate Custom Entities dialog as shown below.
    Do not select the CONTACT database table. Later on in this tutorial, you will use the CONTACT database table to manually create the Plain Old Java Object (POJO) class Contact and annotate this class for JPA in order to better understand the top-down development approach.

  1. Click Next.
  2. The Table Associations dialog displays entity relationships as observed in the database schema from the foreign key definitions. The dialog allows you to edit a table association by selecting each association and modifying its options in the editing panel.
    Select the association between LINEITEM and ORDER_DATA.
    Change the value of the first Property field from orderData to order.

  1. Select the association between LINEITEM and PRODUCT.
    Here, you want to define many-to-one unidirectional relationship between LINEITEM and PRODUCT. Uncheck the checkbox Generate a reference to a collection of LINEITEM in PRODUCT.

  1. Select the association between ORDER_DATA and CUSTOMER.
    Change the value of the second Property field from orderData to order.

  1. Click Next.
  2. In the Customize Default Entity Generation dialog, confirm that none is selected in the Key generator field.
    Set Entity Access to Property, and for Collection properties type, verify that java.util.List is selected.
    A Java package is required for generating the entity beans. Enter oracle.beans as the Domain Java Class (as shown below), and the package will be created automatically upon completion of the dialog.
    Click Next.

  1. The Customize Individual Entities dialog allows you to customize the generation of table and column mapping. We will not customize the tables in this tutorial, but note that you can see how tables and columns can generate flexible, maintainable Java source.

  1. Click Finish.
  2. You can access the entities through the Project Explorer view under the Java Resources: Java branch of the project. In the Project Explorer view, you can find the object model under the package com.bea.beans of the branch web/WEB-INF/src/java.
    1. To view the set of persistence entities generated by Oracle Enterprise Pack for Eclipse, navigate to the persistence.xml file within your Web project. Oracle Enterprise Pack for Eclipse identifies the persistent entity-based class names of entities specified in persistence.xml file.

Review generated classes with annotations
When you create entity mappings, you define each property as having one of six property types: basic, id, many-to-one, one-to-one, one-to-many, and many-to-many. When you generate entities from a database, Oracle Enterprise Pack for Eclipse annotates the generated source code with JPA annotations that designate which type a given property is. This section reviews some basic JPA annotations.

Review the following annotations in the class Customer.

  1. Double-click the file oepe-jpa-tutorial > web/WEB-INF/src/java > com.bea.beans > Customer.java to view its source.
  2. Basic Properties: A basic property handles a standard value that is persisted as-is to the database.

    The @Basic annotation is followed by the @Column annotation defining an attribute name, which is the name of the column to which the property is bound; the attribute nullable is false, to specify that the column cannot store null values; the column length attribute specifies the maximum length.

public String getName() {
return this.name;
public void setName(String name) {
this.name = name;

  1. One-to-Many Properties: A one-to-many property designates a relationship in which one A entity references multiple B entities, and no two A entities reference the same B entity.
    Here a Customer entity references multiple OrderData entities, but an OrderData entity can have only one Customer entity reference.
    The one-to-many annotation defines an attribute mappedBy, which is the name of the many-to-one field in OrderData entity that maps this bidirectional relation.


@OneToMany(mappedBy="customer", fetch=FetchType.EAGER)
public java.util.Set<OrderData> getOrders() {
return this.orders;
public void setOrders(java.util.Set<OrderData> orders) {
this.orders = orders;

  1. Id properties: An Id property designates an identifier, such as a primary key. All entity beans must declare one or more fields that together form the persistent identity of an instance.
    An Id annotation is followed by an @Column annotation defining the attribute unique, which is true to specify that the column is UNIQUE in the SQL sense (can have only unique values).

public Integer getCustomerid() {
return this.customerid;
public void setCustomerid(Integer customerid) {
this.customerid = customerid;

  1. Double-click the class file OrderData.java.
    Many-to-one Properties: A many-to-one property designates a relationship in which an entity A references a single entity B, and other As might also reference the same B; there is a many-to-one relation from A to B.
    The many-to-one annotation defines an attribute fetch, which is an enum that specifies whether to load the field's persisted data before the entity object is returned by the persistence provider (FetchType.EAGER) or later, when the property is accessed (FetchType.LAZY).
    The many- to-one annotation is followed by an @JoinColumn annotation defining the column name, which is the name of the column to which the property is bound, and a referencedColumnName attribute, which is the name of the primary key column being joined to.

@JoinColumn(name="CUSTOMERID", referencedColumnName="CUSTOMERID")
public Customer getCustomer() {
return this.customer;
public void setCustomer(Customer customer) {
this.customer = customer;

In Part 3, I will discuss how to create and manage entities.

More Stories By Pieter Humphrey

Pieter Humphrey has been at Oracle (by way of BEA Systems) for 7+ years, working in development, marketing, sales, and developer relations to advance Java technology in the enterprise. He ran the dev2dev community at BEA and continues to with work with Oracle OTN and Eclipse Foundation communities. His current role is focused on application development tools like Oracle Enterprise Eclipse Pack, Oracle Workshop for WebLogic, JDeveloper, TopLink and the ADF framework, and is a frequent speaker at industry events and workshops.

Comments (0)

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.

@ThingsExpo Stories
Predicting the future has never been more challenging - not because of the lack of data but because of the flood of ungoverned and risk laden information. Microsoft states that 2.5 exabytes of data are created every day. Expectations and reliance on data are being pushed to the limits, as demands around hybrid options continue to grow.
The standardization of container runtimes and images has sparked the creation of an almost overwhelming number of new open source projects that build on and otherwise work with these specifications. Of course, there's Kubernetes, which orchestrates and manages collections of containers. It was one of the first and best-known examples of projects that make containers truly useful for production use. However, more recently, the container ecosystem has truly exploded. A service mesh like Istio addr...
Digital Transformation: Preparing Cloud & IoT Security for the Age of Artificial Intelligence. As automation and artificial intelligence (AI) power solution development and delivery, many businesses need to build backend cloud capabilities. Well-poised organizations, marketing smart devices with AI and BlockChain capabilities prepare to refine compliance and regulatory capabilities in 2018. Volumes of health, financial, technical and privacy data, along with tightening compliance requirements by...
As IoT continues to increase momentum, so does the associated risk. Secure Device Lifecycle Management (DLM) is ranked as one of the most important technology areas of IoT. Driving this trend is the realization that secure support for IoT devices provides companies the ability to deliver high-quality, reliable, secure offerings faster, create new revenue streams, and reduce support costs, all while building a competitive advantage in their markets. In this session, we will use customer use cases...
Business professionals no longer wonder if they'll migrate to the cloud; it's now a matter of when. The cloud environment has proved to be a major force in transitioning to an agile business model that enables quick decisions and fast implementation that solidify customer relationships. And when the cloud is combined with the power of cognitive computing, it drives innovation and transformation that achieves astounding competitive advantage.
DevOpsSummit New York 2018, colocated with CloudEXPO | DXWorldEXPO New York 2018 will be held November 11-13, 2018, in New York City. Digital Transformation (DX) is a major focus with the introduction of DXWorldEXPO within the program. Successful transformation requires a laser focus on being data-driven and on using all the tools available that enable transformation if they plan to survive over the long term. A total of 88% of Fortune 500 companies from a generation ago are now out of bus...
With 10 simultaneous tracks, keynotes, general sessions and targeted breakout classes, @CloudEXPO and DXWorldEXPO are two of the most important technology events of the year. Since its launch over eight years ago, @CloudEXPO and DXWorldEXPO have presented a rock star faculty as well as showcased hundreds of sponsors and exhibitors! In this blog post, we provide 7 tips on how, as part of our world-class faculty, you can deliver one of the most popular sessions at our events. But before reading...
DXWordEXPO New York 2018, colocated with CloudEXPO New York 2018 will be held November 11-13, 2018, in New York City and will bring together Cloud Computing, FinTech and Blockchain, Digital Transformation, Big Data, Internet of Things, DevOps, AI, Machine Learning and WebRTC to one location.
DXWorldEXPO LLC announced today that ICOHOLDER named "Media Sponsor" of Miami Blockchain Event by FinTechEXPO. ICOHOLDER give you detailed information and help the community to invest in the trusty projects. Miami Blockchain Event by FinTechEXPO has opened its Call for Papers. The two-day event will present 20 top Blockchain experts. All speaking inquiries which covers the following information can be submitted by email to [email protected] Miami Blockchain Event by FinTechEXPO also offers s...
DXWorldEXPO | CloudEXPO are the world's most influential, independent events where Cloud Computing was coined and where technology buyers and vendors meet to experience and discuss the big picture of Digital Transformation and all of the strategies, tactics, and tools they need to realize their goals. Sponsors of DXWorldEXPO | CloudEXPO benefit from unmatched branding, profile building and lead generation opportunities.
Dion Hinchcliffe is an internationally recognized digital expert, bestselling book author, frequent keynote speaker, analyst, futurist, and transformation expert based in Washington, DC. He is currently Chief Strategy Officer at the industry-leading digital strategy and online community solutions firm, 7Summits.
Digital Transformation and Disruption, Amazon Style - What You Can Learn. Chris Kocher is a co-founder of Grey Heron, a management and strategic marketing consulting firm. He has 25+ years in both strategic and hands-on operating experience helping executives and investors build revenues and shareholder value. He has consulted with over 130 companies on innovating with new business models, product strategies and monetization. Chris has held management positions at HP and Symantec in addition to ...
Cloud-enabled transformation has evolved from cost saving measure to business innovation strategy -- one that combines the cloud with cognitive capabilities to drive market disruption. Learn how you can achieve the insight and agility you need to gain a competitive advantage. Industry-acclaimed CTO and cloud expert, Shankar Kalyana presents. Only the most exceptional IBMers are appointed with the rare distinction of IBM Fellow, the highest technical honor in the company. Shankar has also receive...
Enterprises have taken advantage of IoT to achieve important revenue and cost advantages. What is less apparent is how incumbent enterprises operating at scale have, following success with IoT, built analytic, operations management and software development capabilities - ranging from autonomous vehicles to manageable robotics installations. They have embraced these capabilities as if they were Silicon Valley startups.
Poor data quality and analytics drive down business value. In fact, Gartner estimated that the average financial impact of poor data quality on organizations is $9.7 million per year. But bad data is much more than a cost center. By eroding trust in information, analytics and the business decisions based on these, it is a serious impediment to digital transformation.
The best way to leverage your Cloud Expo presence as a sponsor and exhibitor is to plan your news announcements around our events. The press covering Cloud Expo and @ThingsExpo will have access to these releases and will amplify your news announcements. More than two dozen Cloud companies either set deals at our shows or have announced their mergers and acquisitions at Cloud Expo. Product announcements during our show provide your company with the most reach through our targeted audiences.
The IoT Will Grow: In what might be the most obvious prediction of the decade, the IoT will continue to expand next year, with more and more devices coming online every single day. What isn’t so obvious about this prediction: where that growth will occur. The retail, healthcare, and industrial/supply chain industries will likely see the greatest growth. Forrester Research has predicted the IoT will become “the backbone” of customer value as it continues to grow. It is no surprise that retail is ...
Andrew Keys is Co-Founder of ConsenSys Enterprise. He comes to ConsenSys Enterprise with capital markets, technology and entrepreneurial experience. Previously, he worked for UBS investment bank in equities analysis. Later, he was responsible for the creation and distribution of life settlement products to hedge funds and investment banks. After, he co-founded a revenue cycle management company where he learned about Bitcoin and eventually Ethereal. Andrew's role at ConsenSys Enterprise is a mul...
DXWorldEXPO LLC announced today that "Miami Blockchain Event by FinTechEXPO" has announced that its Call for Papers is now open. The two-day event will present 20 top Blockchain experts. All speaking inquiries which covers the following information can be submitted by email to inf[email protected] Financial enterprises in New York City, London, Singapore, and other world financial capitals are embracing a new generation of smart, automated FinTech that eliminates many cumbersome, slow, and expe...
Cloud Expo | DXWorld Expo have announced the conference tracks for Cloud Expo 2018. Cloud Expo will be held June 5-7, 2018, at the Javits Center in New York City, and November 6-8, 2018, at the Santa Clara Convention Center, Santa Clara, CA. Digital Transformation (DX) is a major focus with the introduction of DX Expo within the program. Successful transformation requires a laser focus on being data-driven and on using all the tools available that enable transformation if they plan to survive ov...