James Moger
2011-10-16 a7a9f7d17fa93b3cfc0e7839727ae27c464f8733
Documentation for Gitblit Manager.
2 files renamed
6 files modified
91 ■■■■■ changed files
build.xml 36 ●●●● patch | view | raw | blame | history
docs/00_index.mkd 6 ●●●● patch | view | raw | blame | history
docs/02_rpc.mkd 6 ●●●●● patch | view | raw | blame | history
docs/04_releases.mkd 4 ●●●● patch | view | raw | blame | history
src/com/gitblit/build/Build.java 5 ●●●● patch | view | raw | blame | history
src/com/gitblit/client/GitblitManager.java 12 ●●●● patch | view | raw | blame | history
src/com/gitblit/client/GitblitManagerLauncher.java 10 ●●●● patch | view | raw | blame | history
src/com/gitblit/client/GitblitPanel.java 12 ●●●●● patch | view | raw | blame | history
build.xml
@@ -85,7 +85,7 @@
        <property name="distribution.zipfile" value="gitblit-${gb.version}.zip" />
        <property name="distribution.warfile" value="gitblit-${gb.version}.war" />
        <property name="fedclient.zipfile" value="fedclient-${gb.version}.zip" />
        <property name="rpcclient.zipfile" value="rpcclient-${gb.version}.zip" />
        <property name="manager.zipfile" value="manager-${gb.version}.zip" />
    </target>
    
    
@@ -267,7 +267,7 @@
                <arg value="%FEDCLIENT%=${fedclient.zipfile}" />
                <arg value="--substitute" />
                <arg value="%RPCCLIENT%=${rpcclient.zipfile}" />
                <arg value="%MANAGER%=${manager.zipfile}" />
                <arg value="--substitute" />
                <arg value="%BUILDDATE%=${gb.versionDate}" />
@@ -417,13 +417,13 @@
    <!-- 
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        Build the stand-alone, Gitblit RPC Client
        Build the stand-alone, Gitblit Manager
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    -->
    <target name="buildRpcClient" depends="compile" description="Builds the stand-alone Gitblit RPC client">
        <echo>Building Gitblit RPC Client ${gb.version}</echo>
    <target name="buildManager" depends="compile" description="Builds the stand-alone Gitblit Manager">
        <echo>Building Gitblit Manager ${gb.version}</echo>
    
        <genjar jarfile="rpcclient.jar">
        <genjar jarfile="manager.jar">
            <resource file="${basedir}/src/com/gitblit/client/splash.png" />
            <resource file="${basedir}/resources/gitblt-favicon.png" />
            <resource file="${basedir}/resources/lock_go_16x16.png" />
@@ -436,7 +436,7 @@
            <resource file="${basedir}/resources/blank.png" />
            <resource file="${basedir}/src/com/gitblit/wicket/GitBlitWebApp.properties" />
                
            <class name="com.gitblit.client.GitblitClientLauncher" />
            <class name="com.gitblit.client.GitblitManagerLauncher" />
            <classfilter>
                <exclude name="org.apache." />
                <exclude name="org.bouncycastle." />
@@ -447,17 +447,17 @@
            </classfilter>
            <classpath refid="master-classpath" />
            <manifest>
                <attribute name="Main-Class" value="com.gitblit.client.GitblitClientLauncher" />
                <attribute name="Main-Class" value="com.gitblit.client.GitblitManagerLauncher" />
                <attribute name="SplashScreen-Image" value="splash.png" />
                <attribute name="Specification-Version" value="${gb.version}" />                
                <attribute name="Release-Date" value="${gb.versionDate}" />
            </manifest>
        </genjar>
        
        <!-- Build the rpc client zip file -->
        <zip destfile="${rpcclient.zipfile}">
        <!-- Build the Manager zip file -->
        <zip destfile="${manager.zipfile}">
            <fileset dir="${basedir}">
                <include name="rpcclient.jar" />
                <include name="manager.jar" />
            </fileset>            
        </zip>
    </target>
@@ -579,7 +579,7 @@
            <arg value="%FEDCLIENT%=${fedclient.zipfile}" />
            <arg value="--substitute" />
            <arg value="%RPCCLIENT%=${rpcclient.zipfile}" />
            <arg value="%MANAGER%=${manager.zipfile}" />
            <arg value="--substitute" />
            <arg value="%BUILDDATE%=${gb.versionDate}" />
@@ -611,7 +611,7 @@
        Compile from source, publish binaries, and build & deploy site
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    -->
    <target name="buildAll" depends="buildGO,buildWAR,buildFederationClient,buildRpcClient,buildSite">
    <target name="buildAll" depends="buildGO,buildWAR,buildFederationClient,buildManager,buildSite">
        <!-- Cleanup -->
        <delete dir="${project.build.dir}" />
        <delete dir="${project.war.dir}" />
@@ -624,7 +624,7 @@
        Publish binaries to Google Code
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    -->
    <target name="publishBinaries" depends="buildGO,buildWAR,buildFederationClient,buildRpcClient" description="Publish the Gitblit binaries to Google Code">
    <target name="publishBinaries" depends="buildGO,buildWAR,buildFederationClient,buildManager" description="Publish the Gitblit binaries to Google Code">
        
        <echo>Uploading Gitblit ${gb.version} binaries</echo>
        
@@ -658,14 +658,14 @@
            summary="Gitblit Federation Client v${gb.version} (command-line tool to clone data from federated Gitblit instances)"
            labels="Featured, Type-Package, OpSys-All" />
        <!-- Upload RpcClient -->
        <!-- Upload Manager -->
        <gcupload 
            username="${googlecode.user}" 
            password="${googlecode.password}" 
            projectname="gitblit" 
            filename="${rpcclient.zipfile}"
            targetfilename="rpcclient-${gb.version}.zip"
            summary="Gitblit RPC Client v${gb.version} (Swing tool to clone repositories and remotely administer a Gitblit server)"
            filename="${manager.zipfile}"
            targetfilename="manager-${gb.version}.zip"
            summary="Gitblit Manager v${gb.version} (Swing tool to remotely administer a Gitblit server)"
            labels="Featured, Type-Package, OpSys-All" />
    </target>
docs/00_index.mkd
@@ -18,7 +18,7 @@
### Tools
- *Gitblit RPC Client* - a Java Swing tool to clone repositories and remotely administer a Gitblit server
- *Gitblit Manager* - a Java/Swing application for remote administration of a Gitblit server
- *Gitblit Federation Client* - a command line tool to clone/pull groups of repositories and optionally users and settings
### Java Runtime Requirement
@@ -27,7 +27,7 @@
### Current Release
**%VERSION%** ([go](http://code.google.com/p/gitblit/downloads/detail?name=%GO%)|[war](http://code.google.com/p/gitblit/downloads/detail?name=%WAR%)|[fedclient](http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%)|[rpcclient](http://code.google.com/p/gitblit/downloads/detail?name=%RPCCLIENT%)) based on [%JGIT%][jgit] &nbsp; *released %BUILDDATE%*
**%VERSION%** ([go](http://code.google.com/p/gitblit/downloads/detail?name=%GO%)|[war](http://code.google.com/p/gitblit/downloads/detail?name=%WAR%)|[fedclient](http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%)|[manager](http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%)) based on [%JGIT%][jgit] &nbsp; *released %BUILDDATE%*
- improved: updated ui with Twitter's Bootstrap CSS toolkit  
    **New:** *web.loginMessage = gitblit*
@@ -35,7 +35,7 @@
    **New:** *web.enableRpcServlet = true*  
    **New:** *web.enableRpcAdministration = false*
- added: reusable JSON RPC client class
- added: Swing RPC Client application for cloning and administration of repositories, users, & federation proposals.
- added: Gitblit Manager (Java/Swing Application) for remote administration of a Gitblit server.
- fixed: federation protocol timestamps.  dates are now serialized to the [iso8601](http://en.wikipedia.org/wiki/ISO_8601) standard.  
    **This breaks 0.6.0 federation clients/servers.**
- fixed: Gitblit now runs on Servlet 3.0 webservers (e.g. Tomcat 7, Jetty 8)
docs/02_rpc.mkd
@@ -33,9 +33,11 @@
<tr><td>LIST_SETTINGS</td><td>-</td><td><em>admin</em></td><td>-</td><td>Properties</td></tr>
</table>
### RPC Client
### Result Codes
An example Java Swing [RPC Client application](http://code.google.com/p/gitblit/downloads/detail?name=rpcclient-%VERSION%.zip) is available and allows remote administration of repositories and users.
### Gitblit Manager
[Gitblit Manager](http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%) is an example Java/Swing application that allows remote administration of a Gitblit server.
This application exercises most methods from the utility class `com.gitblit.utils.RpcUtils`.
### EGit "Import from Gitblit" Feature (Planning)
docs/04_releases.mkd
@@ -1,7 +1,7 @@
## Release History
### Current Release
**%VERSION%** ([go](http://code.google.com/p/gitblit/downloads/detail?name=%GO%)|[war](http://code.google.com/p/gitblit/downloads/detail?name=%WAR%)|[fedclient](http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%)|[rpcclient](http://code.google.com/p/gitblit/downloads/detail?name=%RPCCLIENT%)) based on [%JGIT%][jgit] &nbsp; *released %BUILDDATE%*
**%VERSION%** ([go](http://code.google.com/p/gitblit/downloads/detail?name=%GO%)|[war](http://code.google.com/p/gitblit/downloads/detail?name=%WAR%)|[fedclient](http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%)|[manager](http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%)) based on [%JGIT%][jgit] &nbsp; *released %BUILDDATE%*
- improved: updated ui with Twitter's Bootstrap CSS toolkit  
    **New:** *web.loginMessage = gitblit*
@@ -9,7 +9,7 @@
    **New:** *web.enableRpcServlet = true*  
    **New:** *web.enableRpcAdministration = false*
- added: reusable JSON RPC client class
- added: Swing RPC Client application for cloning and administration of repositories, users, & federation proposals.
- added: Gitblit Manager (Java/Swing Application) for remote administration of a Gitblit server.
- fixed: federation protocol timestamps.  dates are now serialized to the [iso8601](http://en.wikipedia.org/wiki/ISO_8601) standard.  
    **This breaks 0.6.0 federation clients/servers.**
- fixed: Gitblit now runs on Servlet 3.0 webservers (e.g. Tomcat 7, Jetty 8)
src/com/gitblit/build/Build.java
@@ -135,14 +135,11 @@
        downloadFromEclipse(MavenObject.JGIT, BuildType.RUNTIME);
    }
    
    public static void rpcClient(DownloadListener listener) {
    public static void manager(DownloadListener listener) {
        downloadListener = listener;
        downloadFromApache(MavenObject.GSON, BuildType.RUNTIME);
        downloadFromApache(MavenObject.JSCH, BuildType.RUNTIME);
        downloadFromApache(MavenObject.SLF4JAPI, BuildType.RUNTIME);
        downloadFromApache(MavenObject.SLF4JNOP, BuildType.RUNTIME);
        downloadFromEclipse(MavenObject.JGIT, BuildType.RUNTIME);
    }
    /**
src/com/gitblit/client/GitblitManager.java
File was renamed from src/com/gitblit/client/GitblitClient.java
@@ -50,7 +50,7 @@
 * @author James Moger
 * 
 */
public class GitblitClient extends JFrame {
public class GitblitManager extends JFrame {
    private static final long serialVersionUID = 1L;
    private JTabbedPane serverTabs;
@@ -60,7 +60,7 @@
    private List<GitblitRegistration> registrations = new ArrayList<GitblitRegistration>();
    private JMenu recentMenu;
    private GitblitClient() {
    private GitblitManager() {
        super();
    }
@@ -68,7 +68,7 @@
        setContentPane(getCenterPanel());
        setIconImage(new ImageIcon(getClass().getResource("/gitblt-favicon.png")).getImage());
        setTitle("Gitblit RPC Client v" + Constants.VERSION + " (" + Constants.VERSION_DATE + ")");
        setTitle("Gitblit Manager v" + Constants.VERSION + " (" + Constants.VERSION_DATE + ")");
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setSize(800, 500);
    }
@@ -135,7 +135,7 @@
        panel.add(newLabelPanel(Translation.get("gb.username"), accountField));
        panel.add(newLabelPanel(Translation.get("gb.password"), passwordField));
        int result = JOptionPane.showConfirmDialog(GitblitClient.this, panel,
        int result = JOptionPane.showConfirmDialog(GitblitManager.this, panel,
                Translation.get("gb.login"), JOptionPane.OK_CANCEL_OPTION);
        if (result != JOptionPane.OK_OPTION) {
            return false;
@@ -163,7 +163,7 @@
                    panel));
            return true;
        } catch (IOException e) {
            JOptionPane.showMessageDialog(GitblitClient.this, e.getMessage(),
            JOptionPane.showMessageDialog(GitblitManager.this, e.getMessage(),
                    Translation.get("gb.error"), JOptionPane.ERROR_MESSAGE);
        }
        return false;
@@ -189,7 +189,7 @@
                    UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
                } catch (Exception e) {
                }
                GitblitClient frame = new GitblitClient();
                GitblitManager frame = new GitblitManager();
                frame.initialize();
                frame.setVisible(true);
            }
src/com/gitblit/client/GitblitManagerLauncher.java
File was renamed from src/com/gitblit/client/GitblitClientLauncher.java
@@ -31,12 +31,12 @@
import com.gitblit.build.Build.DownloadListener;
/**
 * Downloads dependencies and launches RPC client.
 * Downloads dependencies and launches Gitblit Manager.
 * 
 * @author James Moger
 * 
 */
public class GitblitClientLauncher {
public class GitblitManagerLauncher {
    public static void main(String[] args) {
        final SplashScreen splash = SplashScreen.getSplashScreen();
@@ -49,7 +49,7 @@
        };
        
        // download rpc client runtime dependencies
        Build.rpcClient(downloadListener);
        Build.manager(downloadListener);
        File libFolder = new File("ext");
        List<File> jars = Launcher.findJars(libFolder.getAbsoluteFile());
@@ -67,8 +67,8 @@
            }
        }
        
        updateSplash(splash, Translation.get("gb.starting") + " Gitblit RPC Client...");
        GitblitClient.main(args);
        updateSplash(splash, Translation.get("gb.starting") + " Gitblit Manager...");
        GitblitManager.main(args);
    }
    private static void updateSplash(final SplashScreen splash, final String string) {
src/com/gitblit/client/GitblitPanel.java
@@ -149,16 +149,6 @@
            }
        });
        final JButton cloneRepository = new JButton(Translation.get("gb.clone"));
        cloneRepository.setEnabled(false);
        cloneRepository.addActionListener(new ActionListener() {
            public void actionPerformed(ActionEvent e) {
                for (RepositoryModel model : getSelectedRepositories()) {
                    System.out.println("TODO Clone " + model);
                }
            }
        });
        nameRenderer = new NameRenderer();
        typeRenderer = new IndicatorsRenderer();
@@ -192,7 +182,6 @@
                boolean selected = repositoriesTable.getSelectedRow() > -1;
                browseRepository.setEnabled(singleSelection);
                delRepository.setEnabled(selected);
                cloneRepository.setEnabled(selected);
                if (selected) {
                    int viewRow = repositoriesTable.getSelectedRow();
                    int modelRow = repositoriesTable.convertRowIndexToModel(viewRow);
@@ -224,7 +213,6 @@
        JPanel repositoryControls = new JPanel();
        repositoryControls.add(refreshRepositories);
        repositoryControls.add(browseRepository);
        repositoryControls.add(cloneRepository);
        repositoryControls.add(createRepository);
        repositoryControls.add(editRepository);
        repositoryControls.add(delRepository);