Automating developer tasks with custom SQLcl scripts. APEX Connect 2017 Berlin,

Transcription

1 Automating developer tasks with custom SQLcl scripts APEX Connect 2017 Berlin,

2 @mennooo About me mennooo Menno Hoogendijk Fulltime APEX developer Working with Oracle since 2008 Tries to be a fullstack developer Speaking at: APEX Connect 2017 RequireJS in Apex 5.1 Automating developer tasks with custom SQLcl scripts Kscope17 Plugin your APEX widgets Powerful JavaScript skills for all APEX developers 2

3 Qualogy in numbers

4 Today s menu What is SQLcl Configuration Usage SQLcl Scripting Scripts Aliases Introduction to Nashorn Demos Tips & tricks

5 Figuring out how it worked was pretty hard (and some code may appear) 5

6 JavaScript truly is scripting Java in SQLcl 6

7 Let the yourney begin 7

8 What is SQLcl SQL Developer Command Line Only 17mb Execute SQL and PLSQL SQL*Plus support New Commands Client Side Scripting 8

9 9

10 Configuration - unzip the file Bin folder (Executables) 10

11 11

12 Configuration - unzip the file Lib folder (Java libraries) 12

13 Configuration (g)login.sql Execute some commands at startup Location: %SQLPATH% Current working directory prompt ########################### prompt # Hi APEX Connect! prompt ########################### prompt set sqlprompt "@ cyan _user'@'_connect_identifier 13

14 Scripting

15 What can we do with scripts? Add extra functionality Automate common tasks Interaction with filesystem Work with JSON objects Integrate with external JavaScript libraries 15

16 Script command script d:\scripts\hello.js "APEXCONNECT" Inline or script files Non persistent Supports arguments Most important use case: Adding custom commands via scripts 16

17 Script: custom command Use case Automate installing Database objects Load script Use custom command Use custom command With additional parameter 17

18 Alias command alias load <alias.xml> You can import an alias from an XML file Supports SQL / PLSQL / JavaScript Persistent Supports bind variables as extra parameters Most important use case: Adding shortcuts for commonly used scripts 18

19 JavaScript with Nashorn JavaScript Engine for SQLcl Requires JRE 1.8 Important differences with JavaScript in browser or Node.JS Use Java Methods in JavaScript 19

20 Best of both worlds Java engine.eval() Java.type() JavaScript 20

21 Nashorn in SQLcl Global Java objects from SQLcl you can use in your script Object Purpose Usage args User arguments [arg1, arg2, arg3] sqlcl Run statements sqlcl.setstmt(stmt) sqlcl.run() ctx Writing output ctx.write(msg) util Getting values from db var a = util.executereturnonecol(stmt) 21

22 Some cool things you can do Changing buffer output to a file or string Clone a connection, open another connection Execute JavaScript on another thread Read/write to directories and files Virtually anything when you load additional Jar files! 22

23 23

24 Demo time!

25 Tips & tricks

26 Take a look at my GitHub Repository 26

27 Nashorn basics console.log() does not exist Use print() or ctx.write() You can load external scripts, also via URL load() var modulea = loadwithnewglobal() Loading files relatively is not possible Use Java Methods in JavaScript var File = Java.type('java.io.File') 27

28 Loading your custom commands Add your custom commands at startup via the login.sql file 28

29 Set what SQLcl has to offer with Java Decompiler 29

30 Thank you!

31 Hier geht es zur Vortragsbewertung: Vielen Dank! apex.doag.org