GraphQL+JavaScript Demo using MLE in APEX (oracle-samples#280)

* MLE Demo * Add files via upload * Rename readme.md to README.md * Rename * Rename MLE Demo to MLE-Demo * Rename book-schema.mjs to book-schema.mjs * Rename MLE Demo to MLE-Demo * Rename MLE Demo to MLE-Demo * Rename MLE Demo to MLE-Demo * Rename MLE Demo to MLE-Demo * Rename MLE Demo to MLE-Demo * Delete javascript/MLE Demo directory * Add files via upload Add sample inventory data * Update book-schema.mjs * Delete graphql.mjs * add link of the upcoming blog * Add files via upload * Delete inventory.xlsx * add license & copyright header * license & copyright header * add license & copyright header * add license & copyright header * add license & copyright header * add license & copyright header * Add files via upload add cleanup.sql to put the database back into a clean state * Update cleanup.sql * add license and copyright to cleanup.sql

Author: salmabek86

javascript/MLE-Demo/README.md

@@ -0,0 +1,11 @@
+# Bookstore App in APEX with JavaScript/MLE and GraphQL
+
+## Introduction
+
+This repository contains the source code and documentation for the blog post titled "Building an end-to-end Bookstore App in APEX using JavaScript/MLE and GraphQL," which will be published soon. The blog post will provide a detailed walkthrough of the steps involved in creating a comprehensive Bookstore App using Oracle Application Express (APEX), JavaScript/MLE, and GraphQL.
+For more information, please refer to our [upcoming blog post](link will be available soon) that will provide the full context and detailed instructions.
+
+## Acknowledgements
+
+- Author/Contributors - Lucas Braun, Principal Program Manager, Salma Elbekraoui, MLE team intern
+- Last Updated By/Date - Lucas Braun, Principal Program Manager, Salma Elbekraoui, MLE team intern, July 2023

javascript/MLE-Demo/book-schema.mjs

@@ -0,0 +1,163 @@
+/*Copyright 2023 Oracle and/or its affiliates.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import {
+ GraphQLSchema,
+ GraphQLObjectType,
+ GraphQLString,
+ GraphQLInt,
+ GraphQLFloat,
+ GraphQLList
+ } from 'graphql';
+ import 'mle-js-fetch'; 
+ import oracledb from 'mle-js-oracledb';
+ 
+ const BASE_URL = "https://www.googleapis.com/books/v1/volumes?q=";
+ 
+ const getBooks = async (SEARCH_URL) => {
+ const conn = oracledb.defaultConnection();
+ conn.execute(`
+ begin
+ utl_http.set_wallet('file:/<absolute-path-to-your-wallet-directory>');
+ end;
+ `);
+ 
+ const response = await fetch(`${BASE_URL}${SEARCH_URL}`, { credentials: "include" });
+ const result = await response.json();
+ return result;
+ }
+ 
+ const imageLinks = new GraphQLObjectType({
+ name: 'IMAGE_LINKS',
+ fields: () => ({
+ thumbnail: { 
+ type: GraphQLString, 
+ },
+ })
+ });
+ 
+ const author = new GraphQLObjectType({
+ name: 'AUTHOR',
+ fields: () => ({
+ name: { 
+ type: GraphQLString,
+ resolve: (author) => author || "Unknown",
+ },
+ })
+ });
+ 
+ const volumeInfo = new GraphQLObjectType({
+ name: 'VOLUME_INFO',
+ fields: () => ({
+ title: {
+ type: GraphQLString,
+ },
+ subtitle: {
+ type: GraphQLString,
+ },
+ publisher: {
+ type: GraphQLString,
+ },
+ description: {
+ type: GraphQLString,
+ },
+ authors: {
+ type: new GraphQLList(author),
+ resolve: (volumeInfo) => volumeInfo.authors || [],
+ },
+ publishedDate: {
+ type: GraphQLString,
+ },
+ imageLinks: {
+ type: imageLinks,
+ },
+ averageRating: {
+ type: GraphQLFloat,
+ },
+ pageCount: {
+ type: GraphQLInt,
+ },
+ language: {
+ type: GraphQLString,
+ }
+ })
+ });
+ 
+ const book = new GraphQLObjectType({
+ name: 'BOOK',
+ fields: () => ({
+ id: {
+ type: GraphQLString,
+ description: 'The id of the book.',
+ },
+ kind: {
+ type: GraphQLString,
+ description: 'The kind of the book.',
+ },
+ etag: {
+ type: GraphQLString,
+ description: 'The etag of the book.',
+ },
+ volumeInfo: {
+ type: volumeInfo,
+ },
+ stock: {
+ type: GraphQLInt,
+ resolve: (book) => {
+ const result = session.execute('select stock from inventory where id = :id', [book.id]);
+ if (result.rows.length > 0) {
+ return result.rows[0][0];
+ } else {
+ return 0;
+ }
+ }
+ },
+ })
+ });
+ 
+ const volumes = new GraphQLObjectType({
+ name: 'VOLUMES',
+ fields: () => ({
+ kind: { 
+ type: GraphQLString, 
+ },
+ totalItems: { 
+ type: GraphQLInt, 
+ },
+ items: { 
+ type: new GraphQLList(book), 
+ },
+ }),
+ });
+ 
+ const queryType = new GraphQLObjectType({
+ name: 'Query',
+ fields: () => ({
+ library: {
+ args: {
+ research: {
+ type: GraphQLString,
+ },
+ },
+ type: volumes,
+ resolve: async (_source, {research}) => await getBooks(research),
+ },
+ }),
+ });
+ 
+ export const schema = new GraphQLSchema({
+ query: queryType,
+ types: [volumes, book, volumeInfo, author, imageLinks]
+ });

javascript/MLE-Demo/card-region.sql

@@ -0,0 +1,24 @@
+/*Copyright 2023 Oracle and/or its affiliates.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+select title,
+ subtitle,
+ thumbnail as imageLinks
+ from json_table( query(:P1_SEARCH), '$[*]'
+ columns(
+ title varchar2(100) path '$.title',
+ subtitle varchar2(100) path '$.subtitle',
+ thumbnail VARCHAR2(4000) path '$.imageLinks.thumbnail'
+ ) ); 

javascript/MLE-Demo/cleanup.sql

@@ -0,0 +1,44 @@
+/*Copyright 2023 Oracle and/or its affiliates.
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+DECLARE
+ l_acl_name VARCHAR2(100);
+ CURSOR c_network_acls IS
+ SELECT acl FROM dba_network_acls WHERE host = '*.googleapis.com';
+BEGIN
+ -- Drop the INVENTORY table
+ BEGIN
+ EXECUTE IMMEDIATE 'DROP TABLE INVENTORY';
+ DBMS_OUTPUT.PUT_LINE('Table INVENTORY dropped successfully.');
+ EXCEPTION
+ WHEN NO_DATA_FOUND THEN
+ DBMS_OUTPUT.PUT_LINE('Table INVENTORY does not exist.');
+ WHEN OTHERS THEN
+ DBMS_OUTPUT.PUT_LINE('An error occurred: ' || SQLERRM);
+ END;
+
+ -- Find the ACL name for host '*.googleapis.com'
+ OPEN c_network_acls;
+ FETCH c_network_acls INTO l_acl_name;
+
+ -- Process each row returned by the cursor
+ WHILE c_network_acls%FOUND LOOP
+ -- Unassign the ACL
+ DBMS_NETWORK_ACL_ADMIN.UNASSIGN_ACL(acl => l_acl_name);
+ FETCH c_network_acls INTO l_acl_name;
+ END LOOP;
+
+ CLOSE c_network_acls;
+ 
+ COMMIT;
+END;
+/

javascript/MLE-Demo/create-inventory.sql

@@ -0,0 +1,20 @@
+/*Copyright 2023 Oracle and/or its affiliates.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+drop table if exists inventory;
+create table inventory(
+ id VARCHAR(128) PRIMARY KEY NOT NULL,
+ stock NUMBER
+);

javascript/MLE-Demo/info.js

@@ -0,0 +1,33 @@
+/*Copyright 2023 Oracle and/or its affiliates.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { graphql } from "graphql";
+import { schema } from "schema";
+
+const queryTemplate = `
+ query BookQuery($searchTerm: String){
+ library(research:$searchTerm){
+ <<FIELDS>>
+ }
+ }
+`;
+
+export const getInfo = async (search, query) => {
+ const fields = query.split(",").map(field => field.trim()).join("\n");
+ const finalQuery = queryTemplate.replace("<<FIELDS>>", fields);
+ const formattedSearch = search.replace(/\s/g, "+");
+ const result = await graphql({ schema, source: finalQuery, variableValues:{searchTerm: formattedSearch }});
+ return result.data ? result.data.library.items : [];
+};

javascript/MLE-Demo/inventory.csv

@@ -0,0 +1,31 @@
+ID,STOCK
+ImZuBgAAQBAJ,72
+oxy9zGDxN5kC,55
+D_rpBpU316YC,63
+zm1qhFRl940C,16
+5HVBAgAAQBAJ,19
+6f6cc9YlR_wC,95
+Vvx9Tof4ZrUC,7
+jGcazfSMBZ0C,22
+IdafwX80SdoC,41
+KhEJBAAAQBAJ,4
+wyKpDwAAQBAJ,93
+w5LZAwAAQBAJ,16
+yqNQAAAAMAAJ,61
+jxwPwLsSJqIC,71
+N7yxDwAAQBAJ,99
+MR-SCgAAQBAJ,85
+Vr4ktwAACAAJ,35
+oqmW4BwSteoC,32
+zGOxoQEACAAJ,94
+tpquCcasMDQC,75
+vTP4sUJukzgC,30
+bYCnywEACAAJ,50
+UA343fijDE8C,20
+oqK4tzQ0xBoC,42
+M_ORBAAAQBAJ,84
+ZnOozwEACAAJ,35
+zanEwAEACAAJ,45
+J4Z2QgAACAAJ,7
+2YL0HAAACAAJ,58
+9YG4jwEACAAJ,84

javascript/MLE-Demo/service.js

@@ -0,0 +1,59 @@
+/*Copyright 2023 Oracle and/or its affiliates.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { graphql } from "graphql";
+import { schema } from "schema";
+
+const queryTemplate = `
+ query BookQuery($searchTerm: String) {
+ library(research: $searchTerm) {
+ items {
+ volumeInfo{
+ title,
+ subtitle,
+ description,
+ imageLinks{
+ thumbnail,
+ },
+ authors{
+ name,
+ },
+ }
+ }
+ }
+ }
+`;
+
+async function getInfo(search) {
+ try {
+ const result = await graphql({
+ schema,
+ source: queryTemplate,
+ variableValues: {
+ searchTerm: search
+ }
+ });
+
+ if (!result || !result.data) {
+ const errorMessage = result && result.errors ? result.errors[0].message : 'No data found';
+ throw new Error(errorMessage);
+ }
+
+ const volumeInfos = result.data.library.items.map(item => item.volumeInfo);
+ return volumeInfos;
+ } catch (error) {
+ throw new Error(`Error retrieving information: ${error.message}`);
+ }
+}