-
Notifications
You must be signed in to change notification settings - Fork 2.5k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #133 from jeffgbutler/master
Store SQL Script Password in Eclipse Secure Storage
- Loading branch information
Showing
16 changed files
with
339 additions
and
32 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
81 changes: 81 additions & 0 deletions
81
eclipse/org.mybatis.generator.eclipse.doc/html-src/eclipseui/usingTheLauncher.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,81 @@ | ||
| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" | ||
| "http://www.w3c.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> | ||
|
|
||
| <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> | ||
| <head> | ||
| <title>Using the Launcher</title> | ||
| <link type="text/css" rel="stylesheet" href="../mbgdoc/mbgstyle.css"/> | ||
| </head> | ||
| <body> | ||
| <h1>Using the Launcher</h1> | ||
| <p>The MyBatis Generator feature includes a custom launcher for | ||
| running MyBatis generator. The launcher leverages Eclipse's launch support | ||
| and enables you to create any number of custom launches. The launcher has far | ||
| more capability than the previous popup menu action. Further, the launch support | ||
| does not alter the Eclipse IDE classpath - which could happen inadvertently with | ||
| the prior popup menu action.</p> | ||
| <p>On this page we will cover some of the technical internals of the launcher. | ||
| We assume you are familiar with how the Eclipse launch support works in general. | ||
| If you are not familiar with Eclipse launching, just know that launch configurations | ||
| can be accessed with the Run>Run Configurations... or Run>Debug Configurations... | ||
| menu options.</p> | ||
|
|
||
| <h2>Launcher Internals</h2> | ||
| <p>Internally the launcher uses the MyBatis Generator Ant task to run the generator. The | ||
| launcher creates an Ant build script based on attributes in the launch | ||
| configuration and then uses Eclipse's Ant support to run the script.</p> | ||
| <p>The launch configuration allows you to specify a SQL script to run | ||
| before the generator is run. This can be useful when using in-memory databases | ||
| and is used during testing of the feature. Running a SQL script is accomplished | ||
| by using Ant's built in | ||
| SQL task to run a script you specify. See the Ant documentation for details | ||
| about the capabilities of the SQL task.</p> | ||
|
|
||
| <h2>Working with the Classpath</h2> | ||
| <p>The launcher allows you to add entries to the runtime classpath | ||
| of the launch. This can be used to add JDBC drivers to the classpath, and could | ||
| also be used to add Eclipse projects to the classpath. If you are developing a | ||
| plugin, you could add your plugin project to the classpath to test your plugin.</p> | ||
| <p>If you are developing a plugin, you do not need to add MyBatis Generator | ||
| itself to the launch classpath as it will already be added by the launcher.</p> | ||
| <p>Adding entries to the launcher classpath is generally preferable to using | ||
| a <code><classPathEntry></code> configuration element in the generator | ||
| configuration file. However, if you use a dependency JAR that relies on native code | ||
| (such as some DB2 drivers) it would be better to use the | ||
| <code><classPathEntry></code> configuration element. This because native | ||
| code can only be loaded by a single classloader and it is likely that | ||
| the generator classloader will be garbage collected before the launch classloader.</p> | ||
|
|
||
| <h2>What's Different in a Debug Launch?</h2> | ||
| <p>If you launch in debug mode, rather than run mode, the launcher will | ||
| launch Ant in debug mode and will log all messages to | ||
| a new Eclipse console called "MyBatis Generator". This can be useful when | ||
| using an SQL script as you will be able to see the script progress in the | ||
| console. You will also see many Ant configuration messages.</p> | ||
| <p>Currently the launcher does not support breakpoints in dependent projects. | ||
| If you are developing a plugin you may add the plugin project to the launcher | ||
| classpath and the plugin will be executed, but any breakpoints set in | ||
| plugin code will be ignored. This is a limitation of Ant support.</p> | ||
|
|
||
| <h2>How Passwords are Stored</h2> | ||
| <p>If you specify a password for connecting to a database with the Ant script, you | ||
| have options on how that password is stored.</p> | ||
| <p>If you select the check box specifying that | ||
| credentials should be stored in secure storage, then the user ID and password will | ||
| be stored in Eclipse's internal secure storage system. The password will be encrypted | ||
| using Eclipse's default support. The password will be in clear text in the generated Ant | ||
| script while the launch is running, but the generated Ant file will be deleted after the | ||
| launch completes.</p> | ||
| <p>If you do not select the check box specifying that | ||
| credentials should be stored in secure storage, then the user ID and password will | ||
| be stored in clear text in the Eclipse launch configuration. The password will also | ||
| be in clear text in the generated Ant script while the launch is running, and the | ||
| generated Ant file will not be deleted after the launch completes.</p> | ||
| <p>Launch configuration files are stored in<br/> | ||
| <code><workspace-directory>/.metadata/.plugins/org.eclipse.debug.core/.launches</code> | ||
| </p> | ||
| <p>The generated Ant files are stored in<br/> | ||
| <code><workspace-directory>/.metadata/.plugins/org.mybatis.generator.eclipse.ui/.generatedAntScripts</code> | ||
| </p> | ||
| </body> | ||
| </html> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
79 changes: 79 additions & 0 deletions
79
....generator.eclipse.ui/antsrc/org/mybatis/generator/eclipse/ui/ant/DebugBuildListener.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,79 @@ | ||
| /** | ||
| * Copyright 2006-2016 the original author or authors. | ||
| * | ||
| * 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. | ||
| */ | ||
| package org.mybatis.generator.eclipse.ui.ant; | ||
|
|
||
| import java.io.IOException; | ||
|
|
||
| import org.apache.tools.ant.BuildEvent; | ||
| import org.apache.tools.ant.BuildListener; | ||
| import org.eclipse.ui.console.ConsolePlugin; | ||
| import org.eclipse.ui.console.IConsole; | ||
| import org.eclipse.ui.console.IOConsole; | ||
| import org.eclipse.ui.console.IOConsoleOutputStream; | ||
|
|
||
| public class DebugBuildListener implements BuildListener { | ||
| private IOConsole console = new IOConsole("MyBatis Generator", null); //$NON-NLS-1$ | ||
| private IOConsoleOutputStream outputStream = console.newOutputStream(); | ||
|
|
||
| public DebugBuildListener() { | ||
| ConsolePlugin.getDefault().getConsoleManager().addConsoles(new IConsole[] {console}); | ||
| } | ||
|
|
||
| @Override | ||
| public void buildStarted(BuildEvent event) { | ||
| writeMessage("MyBatis Generator Started"); //$NON-NLS-1$ | ||
| } | ||
|
|
||
| @Override | ||
| public void buildFinished(BuildEvent event) { | ||
| writeMessage("MyBatis Generator Finished"); //$NON-NLS-1$ | ||
| } | ||
|
|
||
| @Override | ||
| public void targetStarted(BuildEvent event) { | ||
| writeMessage("Target " + event.getTarget().getName() + " - Started"); //$NON-NLS-1$ //$NON-NLS-2$ | ||
| } | ||
|
|
||
| @Override | ||
| public void targetFinished(BuildEvent event) { | ||
| writeMessage("Target " + event.getTarget().getName() + " - Finished"); //$NON-NLS-1$ //$NON-NLS-2$ | ||
| } | ||
|
|
||
| @Override | ||
| public void taskStarted(BuildEvent event) { | ||
| writeMessage("Task " + event.getTask().getTaskName() + " - Started"); //$NON-NLS-1$ //$NON-NLS-2$ | ||
| } | ||
|
|
||
| @Override | ||
| public void taskFinished(BuildEvent event) { | ||
| writeMessage("Task " + event.getTask().getTaskName() + " - Finished"); //$NON-NLS-1$ //$NON-NLS-2$ | ||
| } | ||
|
|
||
| @Override | ||
| public void messageLogged(BuildEvent event) { | ||
| writeMessage(" " + event.getMessage()); //$NON-NLS-1$ | ||
| } | ||
|
|
||
| private void writeMessage(String message) { | ||
| try { | ||
| outputStream.write(message); | ||
| outputStream.write('\n'); | ||
| outputStream.flush(); | ||
| } catch (IOException e) { | ||
| e.printStackTrace(); | ||
| } | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.