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

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
All in Mobile is a place where we continually maximize their impact by fostering understanding, empathy, insights, creativity and joy. They believe that a truly useful and desirable mobile app doesn't need the brightest idea or the most advanced technology. A great product begins with understanding people. It's easy to think that customers will love your app, but can you justify it? They make sure your final app is something that users truly want and need. The only way to do this is by ...
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 ...
DXWorldEXPO LLC announced today that Big Data Federation to Exhibit at the 22nd International CloudEXPO, colocated with DevOpsSUMMIT and DXWorldEXPO, November 12-13, 2018 in New York City. Big Data Federation, Inc. develops and applies artificial intelligence to predict financial and economic events that matter. The company uncovers patterns and precise drivers of performance and outcomes with the aid of machine-learning algorithms, big data, and fundamental analysis. Their products are deployed...
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...
The challenges of aggregating data from consumer-oriented devices, such as wearable technologies and smart thermostats, are fairly well-understood. However, there are a new set of challenges for IoT devices that generate megabytes or gigabytes of data per second. Certainly, the infrastructure will have to change, as those volumes of data will likely overwhelm the available bandwidth for aggregating the data into a central repository. Ochandarena discusses a whole new way to think about your next...
CloudEXPO | DevOpsSUMMIT | DXWorldEXPO 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.
Cell networks have the advantage of long-range communications, reaching an estimated 90% of the world. But cell networks such as 2G, 3G and LTE consume lots of power and were designed for connecting people. They are not optimized for low- or battery-powered devices or for IoT applications with infrequently transmitted data. Cell IoT modules that support narrow-band IoT and 4G cell networks will enable cell connectivity, device management, and app enablement for low-power wide-area network IoT. B...
The hierarchical architecture that distributes "compute" within the network specially at the edge can enable new services by harnessing emerging technologies. But Edge-Compute comes at increased cost that needs to be managed and potentially augmented by creative architecture solutions as there will always a catching-up with the capacity demands. Processing power in smartphones has enhanced YoY and there is increasingly spare compute capacity that can be potentially pooled. Uber has successfully ...
SYS-CON Events announced today that CrowdReviews.com has been named “Media Sponsor” of SYS-CON's 22nd International Cloud Expo, which will take place on June 5–7, 2018, at the Javits Center in New York City, NY. CrowdReviews.com is a transparent online platform for determining which products and services are the best based on the opinion of the crowd. The crowd consists of Internet users that have experienced products and services first-hand and have an interest in letting other potential buye...
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...