Open Source Cloud Authors: Zakia Bouachraoui, Yeshim Deniz, Elizabeth White, Pat Romanski, Liz McMillan

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.

IoT & Smart Cities Stories
In his general session at 19th Cloud Expo, Manish Dixit, VP of Product and Engineering at Dice, discussed how Dice leverages data insights and tools to help both tech professionals and recruiters better understand how skills relate to each other and which skills are in high demand using interactive visualizations and salary indicator tools to maximize earning potential. Manish Dixit is VP of Product and Engineering at Dice. As the leader of the Product, Engineering and Data Sciences team at D...
When talking IoT we often focus on the devices, the sensors, the hardware itself. The new smart appliances, the new smart or self-driving cars (which are amalgamations of many ‘things'). When we are looking at the world of IoT, we should take a step back, look at the big picture. What value are these devices providing. IoT is not about the devices, its about the data consumed and generated. The devices are tools, mechanisms, conduits. This paper discusses the considerations when dealing with the...
Bill Schmarzo, Tech Chair of "Big Data | Analytics" of upcoming CloudEXPO | DXWorldEXPO New York (November 12-13, 2018, New York City) today announced the outline and schedule of the track. "The track has been designed in experience/degree order," said Schmarzo. "So, that folks who attend the entire track can leave the conference with some of the skills necessary to get their work done when they get back to their offices. It actually ties back to some work that I'm doing at the University of San...
Bill Schmarzo, author of "Big Data: Understanding How Data Powers Big Business" and "Big Data MBA: Driving Business Strategies with Data Science," is responsible for setting the strategy and defining the Big Data service offerings and capabilities for EMC Global Services Big Data Practice. As the CTO for the Big Data Practice, he is responsible for working with organizations to help them identify where and how to start their big data journeys. He's written several white papers, is an avid blogge...
Dynatrace is an application performance management software company with products for the information technology departments and digital business owners of medium and large businesses. Building the Future of Monitoring with Artificial Intelligence. Today we can collect lots and lots of performance data. We build beautiful dashboards and even have fancy query languages to access and transform the data. Still performance data is a secret language only a couple of people understand. The more busine...
If a machine can invent, does this mean the end of the patent system as we know it? The patent system, both in the US and Europe, allows companies to protect their inventions and helps foster innovation. However, Artificial Intelligence (AI) could be set to disrupt the patent system as we know it. This talk will examine how AI may change the patent landscape in the years to come. Furthermore, ways in which companies can best protect their AI related inventions will be examined from both a US and...
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.
Chris Matthieu is the President & CEO of Computes, inc. He brings 30 years of experience in development and launches of disruptive technologies to create new market opportunities as well as enhance enterprise product portfolios with emerging technologies. His most recent venture was Octoblu, a cross-protocol Internet of Things (IoT) mesh network platform, acquired by Citrix. Prior to co-founding Octoblu, Chris was founder of Nodester, an open-source Node.JS PaaS which was acquired by AppFog and ...
The deluge of IoT sensor data collected from connected devices and the powerful AI required to make that data actionable are giving rise to a hybrid ecosystem in which cloud, on-prem and edge processes become interweaved. Attendees will learn how emerging composable infrastructure solutions deliver the adaptive architecture needed to manage this new data reality. Machine learning algorithms can better anticipate data storms and automate resources to support surges, including fully scalable GPU-c...
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...