温馨提示:本篇是用于团队开发协作的github,如果是单人的可以移步本系列另外一篇 集成eclipse较为简单
团队仓库目录结构
- TestOrgName
- xxxsystem
- configs
- dbscripts
- docs
- src
- xxxsystem
下面一一说一下这些目录的作用:
TestOrgName
团队/组织名,可以自定义,最好用英文。
xxxsystem
团队要做的项目名称,可以自定义,最好用英文。
configs
在开发的时候,项目是部署在开发环境中的,所以项目中的一些配置文件,比如:数据库连接配置文件,都是用的开发环境的数据库连接配置,项目要部署上线的时候,我们需要把开发环境的数据库连接配置替换成生产环境的数据库连接配置,所以这个目录可以用来存生产环境的相关配置文件。
之所以将测试环境/开发环境/生产环境分开是因为开发过程中,需要对数据库中的一些数据进行测试或者修改,如果不和生产环境分开,会“污染”生产环境的数据。
dbscripts
在开发过程中,每次开发过程中涉及到要执行一些脚本,比如:开发过程中,要新建一个表,建表语句就要保存在这个目录里面,待开发完毕上线的时候,就需要在生产环境中执行这个建表语句。
docs
这里存放项目的相关文档,比如:需求说明书,会议纪要,上线手册等。
src
这里存放项目源码。
一个例子
我们通过这个简单的例子来说明如何配置相关目录中的信息。
团队基本信息
- 团队名称:PhoenixGoGo
- 团队要做的项目名称:helloworld
在Github中新建团队
新建organization
输入Organization Name等相关信息,并点击Create organization
邀请成员,这步我们先略过,点击Finish
此时,我们就把团队仓库新建完毕。
在团队仓库中新建项目
点击Create a new repository
输入项目相关信息, 并点击Create repository
此时,我们就把项目建好了。
初始化相关目录
先将项目clone至本地:
git clone https://github.com/PhoenixGoGo/helloworld.git 这是你安装完git在命令窗口输入的
进入项目目录,并新建以下文件夹:
项目需求
我们要将控制台输入的文本写入到C盘根目录中的file_product
文件夹中的ds.txt
文件中。
配置和初始化
为了不影响生产环境file_product
文件夹中的ds.txt
文件, 我们考虑在C盘根目录中新建一个file_develop
的文件夹,并在这个文件夹里面ds.txt
文件,我们平时在开发的时候,就读取file_develop
中的ds.txt
文件,等我们开发完毕测试通过以后,我们可以把相关的目录改为file_product
。
为了说明问题,我通过脚本来新建相关目录,以Windows为例,
- 新建一个名为
init_ds.bat
文件, - 用记事本打开这个文件写入以下内容并保存:
@echo off
md "C:file_develop"
C:
cd "C:file_develop"
cd.>ds.txt
双击这个bat文件,可以在C盘下生成了相关目录和文件。同时,我们把init_ds.bat
文件放到helloworld/dbscripts
文件夹下面。
因为以后发布项目的时候要切换目录,所以,我们不能把要读取的目录写死在代码里面,我们可以将目录路径写在配置文件里面,通过读取配置文件来获得目录的路径,这样我们在部署的时候只需要用生产环境的配置文件覆盖开发环境的配置文件即可。
我们可以新建两个配置文件,一个用于开发环境,一个用于生产环境。
我们先新建一个开发环境中需要的配置文件:
- 新建一个名为
config.properties
的配置文件, - 用记事本打开这个文件写入以下内容并保存:
# test environment file.name=C:/file_develop/ds.txt
再新建一个生产环境中需要的配置文件:
- 新建一个名为
config.properties
的配置文件, - 用记事本打开这个文件写入以下内容并保存:
# product environment file.name=C:/file_product/ds.txt
我们把这个用于生产的配置文件放在helloworld/configs
下面。
项目源码(部分)
import java.io.BufferedWriter; import java.io.File; import java.io.FileInputStream; import java.io.FileWriter; import java.io.IOException; import java.util.Properties; import java.util.Scanner; public class App { private static Scanner scanner; public static void main(String[] args) { Properties prop = new Properties(); try { prop.load(new FileInputStream("config/config.properties")); scanner = new Scanner(System.in); String line = null; System.out.print("please input:"); while (!"exit".equals(line = scanner.nextLine())) { System.out.println("input context = " + line); System.out.print("please input: "); File writename = new File(prop.getProperty("file.name")); writename.createNewFile(); BufferedWriter out = new BufferedWriter(new FileWriter(writename)); out.write(line); out.flush(); out.close(); } System.out.println("The program will exit"); } catch (IOException e) { e.printStackTrace(); } } }
我们将源码放入helloworld/src
目录下。
我们将helloworld
push到远程仓库:
控制台下分别执行以下命令:
cd helloworld
git add *
git commit -m "if applied, this commit will init project"
git push -u origin master
此时,项目的结构是这样的:
开发环境
安装
相关配置
打开Eclipse,设置编码格式UTF-8
:
Window->Preferences->General->Workspace->Text file encoding->UTF-8
在Eclipse中打开:
Window->Show View->Other...->找到Git Repositories并双击
Window->Show View->Other...->找到Git Staging并双击
配置Maven到Eclipse中:
Window->Preferences->Maven->Installations->Add...->选择前面安装的Maven的目录
点击Finish。
导入仓库
在Git Repositories
下点击clone git repository
输入URI以及Github用户名和密码
点击finsh
导入项目
在控制台下,我们进入源码的目录执行:
mvn eclipse:eclipse
在src
目录下右键,选择Import Projects
:
选择import existing Eclipse Projects
:
项目导入完成
运行项目
选择App.java
右键-> Run As->Java Application
以上为helloworld
这个项目的开发部署文档, 我们可以将其保存为:develop_guide.md
文件,
并且放到hellworld/docs
目录下
最后,把docs目录也提交到团队仓库中去。
增加团队成员
团队仓库初始化好以后,我们可以增加团队成员进行协作开发:
点击Invite member
输入你的团队成员的Github账户即可对相应的成员发出邀请,接收到邀请的成员要进Github注册邮箱进行确认方可加入:
这里包含两类人:Member/Owner :
他们拥有的权限可以自定义,管理员可根据需要配置不同团队成员的权限:
转自 http://www.cnblogs.com/greyzeng/p/6044837.html
github 就谈论到这吧,如果有错误之处,欢迎留言指正~