实现VSS（Visual Source Safe）的Java API

最新推荐文章于 2022-07-31 21:14:55 发布
最新推荐文章于 2022-07-31 21:14:55 发布
阅读量7.8k 收藏 4
点赞数
分类专栏： Java开源 微软技术 文章标签： vss java string jni path null
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/tyrone1979/article/details/1487903
版权
本文介绍如何使用Java Native Interface (JNI) 实现对Visual Source Safe (VSS) 的API调用，从而在Java中进行VSS的操作，如连接、断开、获取项目、数据库名、文件等。通过VC++编写动态链接库，实现Java中的native方法，调用VSS的COM组件进行交互。
摘要由CSDN通过智能技术生成
              VSS，即Visual Source Safe，是微软公司开发的Windows平台上优秀的Source版本控制器。不同于CVS的是，它不是开源，因此支持VSS的只有Windows平台。但微软发布了VSS的API。任何开发者都可以通过ssapi.dll文件，开发自定义的VSS插件或其他工具。Ssapi.dll是ActiveX组件，自然能支持多种开发语言。但想要支持Java，就得使用JNI了。
本文使用JNI实现访问VSS的Java api。
1．VSS Java API
 
定义VSS Java API。
 
package org.colimas.scm.vss;
 
/**
 * VSS Operator class that will call native method.
 * @author tyrone
 *
 */
public class VSSOperator {
 
              private static String LIBPATH="vssperator.dll";
 
              public static String ROOT="$/";
              /**
               * load dll
               *
               */
              public VSSOperator(){
                            String path=Thread.currentThread().getContextClassLoader().getResource("./").getPath();
                            path=path+LIBPATH;
                            System.load(path);
              }
              /**
               * load dll
               *
               */        
              public VSSOperator(String libPath){
                            System.load(libPath);
              }
              /**
               * Connect to VSS
               * @param path srcsafe.ini file path.
               * @param id   user id
               * @param pass password
               * @return
               */
              public native boolean connection(String path,String id,String pass);
              /**
               * disconnect from VSS
               *
               */
              public native void disconnection();
              /**
               * get current project.
               * @return
               */
              public native String getCurrentProject();
              /**
               * get database name
               * @return
               */
              public native String getDatabaseName();
              /**
               * get item names from specified path.
               * @param path
               * @return
               */
              public native String[] getItemNames(String path);
              /**
               * get specified file(s) from VSS to local.
               * @param itemName
               * @param localPath
               * @param flag
               * @return
               */
              public native boolean getFile(String itemName,String localPath,int flag);
             
              /**
               * get specified version of one file from VSS to local.
               * @param itemName
               * @param localPath
               * @param version
               * @param flag
               * @return
               */
              public native boolean getVersion(String itemName,String localPath,int version,int flag);
              /**
               * checkout specified file(s) from vss to local.
               * @param itemName
               * @param localPath
               * @param comment
               * @param flag
               * @return
               */
              public native boolean checkout(String itemName,String localPath,String comment,int flag);
              /**
               * check file(s) in VSS
               * @param itemName
               * @param localPath
               * @param comment
               * @param flag
               * @return
               */
              public native boolean checkin(String itemName,String localPath,String comment,int flag);
              /**
               * undo check out action
               * @param itemName
               * @param localPath
               * @param flag
               * @return
               */
              public native boolean undoCheckout(String itemName,String localPath,int flag);
}
 
每个native方法都由VC++实现。
 
2．VSS的API
CodeProject网站上有一些VSS API的相关文章，本文借鉴了下面link的内容。 http://www.codeproject.com/samples/SSBrowser.asp。
从该网站上下载source，内有一个头文件ssauto.h是访问VSS API的关键。该文件定义了VSSAPI涉及到的所有接口，本文使用的接口有：
IVSSDatabase：VSS数据库接口。该接口负责创建连接和获得IVSSItem。
IVSSItem：VSS内的某个文件或工程，该接口负责返回文件或项目信息，Checkout，Checkin，获得文件等。
IVSSItems：VSS内某些文件或工程，IVSSItem集合。
 
 
3．Native方法实现
 
3.1 搭建开发环境
 
3.1.1．使用javah命令生成JNI的头文件。
D:/ >javah -classpath ./;D:/MyProject/colima
s/ra/SCMResources/bin/classes org.colimas.scm.vss.VSSOperator
生成一个叫org_colimas_scm_vss_VSSOperator.h的文件。
 
3.1.2．创建VC++的Dynamic Link Library支持MFC的工程。将org_colimas_scm_vss_VSSOperator.h文件和ssauto.h文件添加到工程内。
3.1.3．在StdAfx.h头文件加入：
#include "ssauto.h"
#include <atlbase.h>
#include <comdef.h>
extern "C" const GUID __declspec(selectany) LIBID_SourceSafeTypeLib =
    {0x783cd4e0,0x9d54,0x11cf,{0xb8,0xee,0x00,0x60,0x8c,0xc9,0xa7,0x1f}};
extern "C" const GUID __declspec(selectany) IID_IVSSItem =
    {0x783cd4e1,0x9d54,0x11cf,{0xb8,0xee,0x00,0x60,0x8c,0xc9,0xa7,0x1f}};
extern "C" const GUID __declspec(selectany) IID_IVSSItems =
    {0x783cd4e5,0x9d54,0x11cf,{0xb8,0xee,0x00,0x60,0x8c,0xc9,0xa7,0x1f}};
extern "C" const GUID __declspec(selectany) IID_IVSSDatabase =
    {0x783cd4e2,0x9d54,0x11cf,{0xb8,0xee,0x00,0x60,0x8c,0xc9,0xa7,0x1f}};
extern "C" const GUID __declspec(selectany) CLSID_VSSItem =
    {0x783cd4e3,0x9d54,0x11cf,{0xb8,0xee,0x00,0x60,0x8c,0xc9,0xa7,0x1f}};
extern "C" const GUID __declspec(selectany) CLSID_VSSDatabase =
    {0x783cd4e4,0x9d54,0x11cf,{0xb8,0xee,0x00,0x60,0x8c,0xc9,0xa7,0x1f}};
extern "C" const GUID __declspec(selectany) IID_IVSS =
    {0x783cd4eb,0x9d54,0x11cf,{0xb8,0xee,0x00,0x60,0x8c,0xc9,0xa7,0x1f}};
 
//并为一些接口定义智能指针
_COM_SMARTPTR_TYPEDEF(IVSSItem, IID_IVSSItem);
_COM_SMARTPTR_TYPEDEF(IVSSItems, IID_IVSSItems);
 
3.1.4．在Option的Directory内加入JDK include和include/win32路径。
 
3.2 方法实现
 
在VC++源程序内加入
#include "org_colimas_scm_vss_VSSOperator.h"
并定义全局变量。
 
IVSSDatabase *pVdb;
IClassFactory *pClf;
3.2.1 connection方法实现
JNI定义为
JNIEXPORT jboolean JNICALL Java_org_colimas_scm_vss_VSSOperator_connection
 (JNIEnv *env, jobject, jstring VSSini, jstring User, jstring Password)
在注册表中查找VSS API组件
     CLSIDFromProgID(L"SourceSafe", &clsid )
              //实例化类工厂。
     CoGetClassObject( clsid, CLSCTX_ALL, NULL,
         IID_IClassFactory, (void**)&pClf )
              //实例化IVSSDatabase
     pClf->CreateInstance( NULL, IID_IVSSDatabase,
           (void **) &pVdb )
              //创建一个VSS连接。
pVdb->Open(bstrPath, bstrUName, bstrUPass)
代码如下：
JNIEXPORT jboolean JNICALL Java_org_colimas_scm_vss_VSSOperator_connection
 (JNIEnv *env, jobject, jstring VSSini, jstring User, jstring Password)
{
//将参数转换为C++基本类型。
              const unsigned short * psz_VSSini=env->GetStringChars(VSSini, 0);
              const unsigned short * psz_User=env->GetStringChars(User, 0);
              const unsigned short * psz_Password=env->GetStringChars(Password, 0);
//再将这些变量转化为COM能识别的类型。
     BSTR bstrPath = SysAllocString(psz_VSSini);
     BSTR bstrUName = SysAllocString(psz_User);
     BSTR bstrUPass = SysAllocString(psz_Password);
           CLSID clsid;    
           jboolean result=JNI_FALSE;
     CoInitialize(0);
     if(S_OK == CLSIDFromProgID(L"SourceSafe", &clsid ))
     {
       if(S_OK == CoGetClassObject( clsid, CLSCTX_ALL, NULL,
         IID_IClassFactory, (void**)&pClf ))
       {
         if(S_OK == pClf->CreateInstance( NULL, IID_IVSSDatabase,
           (void **) &pVdb ))
         {
           if(S_OK == pVdb->Open(bstrPath, bstrUName, bstrUPass))
           {
#ifdef _DEBUG
              AfxMessageBox("Open successfully",MB_OK,0);
#endif
                                           result=JNI_TRUE;
           }else{
#ifdef _DEBUG
                                           AfxMessageBox("Open failed",MB_OK,0);
#endif
                               }
         }else
                             {
                                           AfxMessageBox("Init failed",MB_OK,0);
                             }
       }
     }else
               {
                                          AfxMessageBox("You didnot install VSS yet",MB_OK,0);
               }
     //CoUninitialize();
             
     SysFreeString(bstrPath);
     SysFreeString(bstrUName);
     SysFreeString(bstrUPass);
               return result;
}
3.2.2 disconnectin实现
 
JNIEXPORT void JNICALL Java_org_colimas_scm_vss_VSSOperator_disconnection
 (JNIEnv *, jobject)
{
              pVdb->Release();
              pClf->Release();
              CoUninitialize();
#ifdef _DEBUG
              AfxMessageBox("Close successfully",MB_OK,0);
#endif
}

3.2.3 getDatabaseName和getCurrentProject实现
 
JNIEXPORT jstring JNICALL Java_org_colimas_scm_vss_VSSOperator_getDatabaseName
 (JNIEnv * env, jobject)
{
              if(pVdb==NULL)
                            return NULL;
              CComBSTR bstrDatabase;
//调用IVSSDatabase方法
              if(S_OK==pVdb->get_DatabaseName(&bstrDatabase))
              {
                            return env->NewString(bstrDatabase,bstrDatabase.Length());
              }else{
#ifdef _DEBUG
              AfxMessageBox("Get DB failed",MB_OK,0);
#endif
                            return NULL;
              }
}
 
/*
 *Get current project in vss
 */
JNIEXPORT jstring JNICALL Java_org_colimas_scm_vss_VSSOperator_getCurrentProject
 (JNIEnv *env, jobject)
{
              if(pVdb==NULL)
                            return NULL;
              CComBSTR bstrProject;
//调用IVSSDatabase方法
              if(S_OK==pVdb->get_CurrentProject(&bstrProject))
              {
 
                            return env->NewString(bstrProject,bstrProject.Length());
              }else
                            return NULL;
}
 
3.2.4 getFile实现
 
JNIEXPORT jboolean JNICALL Java_org_colimas_scm_vss_VSSOperator_getFile
 (JNIEnv *env, jobject, jstring itemName, jstring localPath, jint flag)
{
              jboolean result=JNI_FALSE;
              if(pVdb==NULL)
                            return result;
              IVSSItemPtr vssRootItem;
              const unsigned short * lpath=env->GetStringChars(itemName,0);
              const unsigned short * llocalPath=env->GetStringChars(localPath,0);
//获得Item实例
              if(pVdb->get_VSSItem(CComBSTR(lpath), FALSE, &vssRootItem)==S_OK)
              {
//获得文件，并将文件下载到本地目录。
                            if(vssRootItem->Get(&CComBSTR(llocalPath),flag)==S_OK)
                            {
                                          result=JNI_TRUE;
                            }
              }
              return result;
}
 
3.2.5 getItemNames实现
 
JNIEXPORT jobjectArray JNICALL Java_org_colimas_scm_vss_VSSOperator_getItemNames
 (JNIEnv *env, jobject, jstring path)
{
              if(pVdb==NULL)
                            return NULL;
              jobjectArray nameArray;
              IVSSItemPtr vssRootItem;
              const unsigned short * lpath=env->GetStringChars(path,0);
//获得父Item。
              if(pVdb->get_VSSItem(CComBSTR(lpath), FALSE, &vssRootItem)==S_OK)
              {
//获得所有子Item集合
                            IVSSItemsPtr vss_items;
                            if(vssRootItem->get_Items(_variant_t(false), &vss_items)==S_OK)
                            {
                                          long l_count;
                                          CComBSTR name;
//获得子Item个数
                                          vss_items->get_Count(&l_count);
                                          nameArray=env->NewObjectArray(l_count,env->FindClass("java/lang/String"),env->NewStringUTF(""));
//遍历
                                          for (long i = 0; i < l_count; i++)
                                          {
                                                        IVSSItemPtr vss_ChildItem;
//获得子Item
                                                        if(vss_items->get_Item(_variant_t(i+1L),
最低0.47元/天 解锁文章
tyrone1979
关注
专栏目录
Visual Source Safe 安装与使用教程
夜飞鼠的专栏
05-01 914
用户成员不能对该数据库中的文件进行直接的修改，而是由版本管理器将该项目的远程序或是子项目的程序拷贝到各个用户成员自己的工作目录下进行调试和修改，然后将修改后的项目文件作check 提交给 vss 来进行更新用户可以根据需要随时快速有效地共享文件，文件一旦被添加进vss，每次改动都会被记录下来，用户可以恢复文件的早期的版本源码文件，用户组也可看到其他成员的有关文档的最新版本，并对其进行修改，vss也同样会将新的改动记录下来。该模式下，只有你可以合法的编辑这文件，对这文件有最终的版本控制权。
java vss
08-21
一个eclipse vss插件，很有用的
C++调用VSS API进行快照
qq_39107008的博客
07-31 799
c++ vss快照
VSS 在Java开发环境MyEclipse中的应用介绍
passport_daizi的博客
02-04 1971
一：MyEclipse中VSS插件的安装 1. 首先需要在MyEclipse中安装vss插件 （1）到官网或http://sourceforge.net/projects/vssplugin/ 下载org.vssplugin_1.6.2.zip。 （2）解压文件，得到org.vssplugin_1.6.2文件夹，把该文件夹拷到MyEclipse安装目录下Eclipse/plugins
java 操作vss,java开发常用工具总结，java开发常用工具
weixin_39969611的博客
03-14 190
java开发常用工具总结，java开发常用工具1.editpluseditplus 是我使用最频繁的工具，不管是java程序还是其他的语言的程序，本人都使用它，方便好用，速度快。如果配置好的话，可以直接编译，发布程序，我甚至使用它和ant，sourcesafe配合，直接进行文件的check in ,check out等操作，不用再打开vss。2.rose做分析设计时必须要用的，配合jbuilder...
java项目管理工具vss6.0
05-23
java项目管理工具vss6.0java项目管理工具vss6.0java项目管理工具vss6.0
VSS.rar_Visual Source Safe_nutshell
09-19
《Visual Source Safe in Nutshell》是由Ajay Kumar所著，Animon Software Solution公司出版的一本关于Microsoft Visual Source Safe（VSS）的详细指南。这本书旨在为开发者和项目团队提供一个全面且实用的VSS使用...
Microsoft Visual Source Safe 2005（VSS安装包）
05-18
Microsoft Visual Source Safe 2005（VSS安装包），Microsoft Visual Source Safe 2005（VSS安装包），Microsoft Visual Source Safe 2005（VSS安装包）
VSS Visual Source Safe
12-21
**Visual SourceSafe (VSS)** 是微软开发的一款版本控制系统，主要面向软件开发团队，用于管理代码和其他项目资源的版本和变更历史。它被集成在**Microsoft Visual Studio** 的环境中，提供了一种方便的方式来跟踪和...
Visual Source Safe
08-12
Visual Source Safe（VSS）是由Microsoft开发的一款源代码版本控制系统，广泛应用于软件开发领域，尤其在JAVA代码版本管理中表现出色。作为一款强大的版本控制工具，VSS对于团队协作、代码管理和项目追踪提供了全面...
javaVSS介绍和用法
01-04
javaVSS介绍和用法，介绍了最基本的一些用法，和高级用法
java_vss便捷插件
12-29
java_vss便捷插件java_vss便捷插件java_vss便捷插件
java_vss帮助学习手册
12-29
java_vss帮助学习手册java_vss帮助学习手册java_vss帮助学习手册
从Visual SourceSafe (VSS)服务器下载文件(C#)
weixin_33831196的博客
11-23 863
< DOCTYPE html PUBLIC -WCDTD XHTML StrictEN httpwwwworgTRxhtmlDTDxhtml-strictdtd> 首先引用ssapi.dll 只需要调用 VSSItem类中的Get就可以下载一个服务器上的文件到本地。如果需要下载指定版本的，需要先get_Version方法，指定特定版本的ite...
java测试vss_VSS项目分支
weixin_39947961的博客
02-27 172
VSS项目分支分类： VSS源码管理 2010-02-24 10:56 14人阅读 评论(0) 收藏 举报假设Demo根目录下面有解决方案Demo1/项目Demo1($/Demo/Demo1/Demo1)，要分支出另一个版式本&/Demo/Demo2/Demo。首先，在Demo目录下创建解决方案目录Demo2(&/Demo/Demo2/Demo2)，右击Demo2弹出快捷菜单中，选...
VSS使用手册(ZZ)
sanuxd的专栏
09-15 1476
1 VSS概述 ????版本控制是工作组软件开发中的重要方面，它能防止意外的文件丢失、允许反追踪到早期版本、并能对版本进行分支、合并和管理。在软件开发和您需要比较两种版本的文件或找回早期版本的文件时，源代码的控制是非常有用的。Visual SourceSafe 是一种源代码控制系统，它提供了完善的版本和配置管理功能，以及安全保护和跟踪检查功能。VSS通过将有关项目文档（包括文本文件、图象文件、
解读Java Class文件格式
热门推荐
tyrone的专栏
07-23 1万+
1．目的大型软件系统开发时，某些Java组件可能涉及到多种数据库或中间件系统的连接和应用，例如一个数据传递组件需要从DB2中读取数据，并将数据通过中间件WebSphere MQ发送到其他系统，这类组件功能单一，但却需要连接多种第三方产品，使得程序员的单元测试变的非常不便，程序员不得不注视或修改部分源代码，或者在本地安装所需第三方产品。无疑这两种选择都是痛苦的。基于以上的不便，本文开发了解析
Visual Source Safe (VSS) 使用详解与指南
"Visual Source Safe (VSS) 使用介绍" Visual Source Safe (VSS) 是一个版本控制系统，尤其适用于小型团队的软件开发协作。作为Microsoft Visual Studio 6.0家族的一部分，VSS提供了有效的源代码管理和版本控制解决...
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值