前言

我们都知道软件开发是工科,不是理科;本质上和电工、钳工是一样的。

也就是说,软件技术成长也与电工、钳工的技术成长是一样的,靠的是练,而不是学。

所以,很多时候,我们称应届大学生是一张白纸,啥也不会。

不论他在学校学的多好,都没用,因为他没练过,不能干活;同理,不论他在学校学的多差,进入工作岗位后,只要肯练,工作也不成问题。

即,刚毕业的学生,只要你做的是工科的软件开发,不是科学类的理科研发;那么,本质上,大家是不存在优秀与普通的差别的。

为什么要学习Java?

在Web端,Java是毫无疑问的领头羊;所以,从事Web开发的Net开发者学习一下Java,其实还是很有益处的,取长补短嘛。 

而且,在工作中我们难免是要遇到和Java接口对接的情况的;如果你足够了解Java,那么,对方是否假配合你很快就能发觉了;如果被人搞到离职了,还跟人称兄道弟的,就有点Low了。

下面,我以IDEA(Java的VisualStudio),创建一个Spring项目,重温一下Java。

Java重温

首先打开IDEA,点击File-New-Project(我手上只有英文版IDEA);如下图:

 

在NewProject界面里,选择Spring Intinalizr,然后勾选Default,点击Next;

然后我们会经历一个【等待界面】,该界面是用来下载Spring模板的;这是因为Spring的模板不在IDEA中集成,所以创建时,需要在网上下载。

由于VisualStudio集成了大量模板,所以,我们几乎不用自己去找模板下载;如果情况特殊,我们需要找模板的话,那也是到网站上下载,然后手动安装。比如MVC2的时代,你想用MVC3的模板。

所以,对于Net开发而言,这种IDE提供下载模板渠道的模式,我们还是比较陌生的。不过IDEA也提供手动安装模板的功能,勾选Custom就可以使用手动安装模式了。

【等待界面】结束后,进入下图界面:

 

这个界面里有两个参数需要设置,一个是Group,一个是Artifact。那么这两个参数的作用是什么呢?

从字面上我是理解不了的,于是我百度了一下。。。然后,呃。。。我还是很混乱。。。

调查后,我大概得出一个结果,就是Group和Artifact是这个项目的唯一标识,Group是组织唯一标识,Artifact是项目唯一标识。

呃。。。我想,对于对于Net开发而言,这应该是很难理解的。项目唯一标识?这是什么鬼?唯一标识这个词怎么听起来像主键呢。。。项目怎么还需要唯一标识呢。。。

那到底要如何解释他们呢?

我想,应该是这样的,Java创建者的初始目的可能是想创建一个地球村共荣圈。。。所以,每一个Java项目都被期待着被共享,如果项目被共享,那么项目就需要唯一标识Artifact。如果一个公司共享了多个项目,那要证明这些项目都从属于该公司,那就需要组织(公司)唯一标识Group。

换成Net的描述就是,你创建的每一个Net项目都被微软期待着,共享到Nuget上,所以你创建项目之前,要先创建这个项目在Nuget上的唯一标识。(很显然微软没有这个期待)

这样,似乎就很好理解Group和Artifact了。

但是,因为现实中,不论Java还是Net都不可能每个项目都共享,所以,当我们做一个非开源项目时,这两个属性设置,就有点鸡肋了。

—————————————————————————————————-

下面看一下,我认为这个界面中第三个重要的属性配置—Package。

可以在图中看到,系统默认把Package赋值成了Group+Artifact的值了—kibagroup.kibaarifact。

这里的Package大约等于C#里的命名空间。呃。。。然后,这个默认赋值我就觉得很奇葩了。。。

比如,你做了唯一标识,Group等于公司名kibacompany,Artifact等于项目kibatest;然后,你项目的默认命名空间就是kibacompany.kibatest。。。

很显然,这件事,对我而言很难理解,还好,IDEA支持我们去修改默认Package。

—————————————————————————————————-

这里我们修改Package为KibaJavaStart。

修改完Package后,我们点击Next继续,如下图:

 

 选择图中的Web项目和其子选项中的Spring Web,然后点击下一步。

 

如上图所示,我们创建项目已经到了最后一步了,因为右下角不在是Next,而是Finish了。

在最后的这个界面里,系统提示我们设置ProjectName(项目名称)。

根据Net的习惯,项目名称通常和默认命名空间一样,所以这里我也赋值KibaJavaStart。

点击Finish,项目创建完成,界面如下:

项目简介

在上图中有三个大文件夹,和若干文件。

文件夹

其中前两个.idea和.mvn分别是IDEA开发工具和Maven管理工具的配置文件、管理文件等等(Maven类似nuget,但它还管理代码的生成和发布。。。貌似比IEDA还好用。。。这里Net开发就需要转变一下观念了,因为Java不是C#一家独大,所以他的相关工具存在的功能重复的问题,所以Java开发通常都是用组合工具在开发,不像我们一个VisualStudio走天下)

第三个src是我们项目的核心文件,java代码都在这里;src我猜就是source的意思,不知道为什么它不用全拼。。。

我们可以看到,在展开的src文件夹中,有着一层,两层,三层。。。呃。。。好多层文件夹。。。谁说的臃肿。。。

呃。。。我们可以看到其中java这个文件夹的颜色是不一样的,它代表的着,它下面的代码是核心Java代码。

与java文件夹同级的resources文件夹,顾名思义,存的是资源文件;不过他这个资源文件几乎什么都可以存储,比如图片,配置字符串,XML数据,SQL查询语句等等。(可能Net项目很少如此集中的存储资源,所以感官上可能会有些奇怪,但我觉得java的这种资源集中的做法是很科学的,非常值得Net开发借鉴学习)

—————————————————————————————————-

文件

在剩下的若干文件中,我们暂时只关注Pom.xml文件;它是Java的配置文件,不过他并不类似于Net的App.config,他相对的更接近Net的.csproj工程文件,里面存储引用了那些Jar包(Net里就是dll)。

Java的Web是有类似于Net的App.config文件的文件的,他叫做web.xml,不过,很明显,我们在这里看不到,我们暂时不关注他,后文会讲到它。

Java里还有个数据配置文件,在这里配置的信息可以在Java代码里被访问;他就是java的数据配置文件在resources文件夹下的application.properties(类似App.config的AppSettings使用configSource把配置文件外放)如下图:

Web项目开发

首先,我们找到我们的默认命名空间,Java里的默认包—KibaJavaStart,如下图:

可以看到,在KibaJavaStart包下只有一个类ArtifactApplication,类里只有一个方法Main。

Main方法?不是Web项目吗?怎么还有Main方法?

如果你这么想,那一定是你Low了,嘿嘿;学一下Asp.Net Core吧,我们的Core也有Main函数了。

Asp.Net Core学习导航

学习了Asp.Net Core我们就了解了,这个承载Main函数的Application类,就是Asp.Net Core的Program类。

吐槽一下

1,现在项目创建完成后,系统在生成一个Main函数启动类时,使用了Arifact的值来做开头;这事很奇怪,Arifact是和Group在第一步一起创建的,两者是上下级关系;但现在Arifact又突然的和最后一步创建默认包名成了上下级关系,这感觉太诡异了,为什么不直接用Application命名呢,非要这样结合一下呢?

2,项目创建完成后自带的项目文件也太少了吧,就一个Main函数启动类,这让人怎么自学啊,逼着我们去看教程啊。

—————————————————————————————————-

言归正传,一起看代码。。。

首先第一行代码,声明包名称。

package KibaJavaStart;

意义很简单,就是声明类所在的包名;不过,这里与C#不同的是,这个包名是固定的,不可修改的。

也就是说,这个类文件在文件夹KibaJavaStart下,他的包名就必须是KibaJavaStart;如果是在文件夹KibaJavaStart/Test下,他的包名就必须是KibaJavaStart.Test。

是的,这的确很不方便,不过,我们换一个角度考虑,Java文件夹的设置已经很臃肿了,刚刚创建就来了好几层,如果不强制包名称和文件夹名一致,那只怕会带来更多的不便。

我们接着看代码。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

声明包名后,引入两个Spring包,理由很简单,因为Main函数要使用这两个包里的内容。

这里import与C#里的Using引用命名空间的用法类似。

因为创建的是Spring项目,所以一些相关的Spring的Jar依赖(类似C#的Dll)已经被默认引用进来了,可以在项目的External Libraries下找到相关引用;如下图:

我们知道在C#项目中,被引用的DLL会被复制一份到本地目录。

不过,在Java项目却不是这样的,我们打开项目的所在文件目录,会发现,目录里并没有这些Jar文件。

所以我猜想,被引用的Jar还在原来的位置,只有被编译的时候才会被调用。

—————————————————————————————————-

在Java里,JDK自带的Jar包相对比Net而言,还是较少的,所以,在开发Java时,通常要引用很多很多个Jar包。

比如Spring框架就不在JDK自带的Jar包里,所以,使用Spring框架开发项目,就要先下载其相应的Jar包。

因为,我们是使用IDEA开发工具开发,而IDEA默认的下载Jar包的工具是Maven,那么下载的Jar包自然是由Maven管理;即,它们应该在Maven工具的所在目录下。

Maven管理工具好像是没有界面的,只能用命令行来操作;不过IDEA为我们提供了操作Maven的界面,现在我们打开IDEA提供的Maven操作界面。

File—Settings—Build,Execution,Deployment—BuildTools—Maven,如下图:

可以看到Maven不仅支持下载Jar包,还支持自定义保存下载Jar包的位置。

图中的Local repository就是保存已下载Jar包的位置了。

—————————————————————————————————-

回到代码。

@SpringBootApplication

这种@开头的东西叫注解,它使用方式与C#的特性类似,要放在类,函数,属性上面;然后在注解(特性)的定义里去找到它的宿主(类or函数or属性),然后为他增加特性;当然,也可设置成只支持类或者只支持函数的模式。

不过Java里的注解实在是太多了、太强大了、太复杂了;注解不仅拥有各种各样的功能,还互相依赖,甚至注解和注解之间还有嵌套;目前Java已经发展到了不使用注解,开发就举步维艰的地步了。

有些注解在Net开发看来,真的有些奇葩,比如这个@Data注解,你都想象不到他是干什么的。 

如上图所示,我们定义了一个实体类DataTest ;类里定义两个私有字段,然后我们在类的头上加了一个Data注解,然后。。。然后。。。

然后,这个Data注解就会自动给这两个私有字段变成属性。。。

也许是因为我定义实体时总是想着他要被充血,所以我才觉得这注解很奇葩吧。。。

在上图中我们还可以看到,@Data注解是红色的,这是因为,我们还没有引入他依赖的Jar包。如何引用呢?呃。。。目前我只知道一种方法。。。

打开pom.xml,找到dependencies标签,在他的下面添加@Data依赖的Jar包 (手敲的),如下图:

图中除了@Data的依赖的lombok包,还有两个依赖,一个是spring-boot-starter,一个是spring-boot-starter-web;简单介绍下,这两个依赖是Spring框架的基础依赖,如果创建项目时未帮我们自动添加这俩依赖,则需要我们手动添加一下,不然会影响项目运行。

PS:在dependency标签中,我们会发现,他的子标签是groupId和artifactId,而spring-boot-starter包和spring-boot-starter-web包的groupId又是一样的,结合我们上文创建项目时设置Group和Artifact,可以想到,spring-boot-starter包和spring-boot-starter-web包都是由org.springframework.boot组织创建的开源项目,而我们在项目中,引用这种开源项目时,需要在dependency标签下增加groupId和artifactId两个标签,并在其中填写这个项目创建时设置的Group和Artifact属性值。

—————————————————————————————————-

在Java的工程文件里添加完依赖后,我们所依赖的Jar并不会被下载,还需要手动使用Maven来下载,(这个下载依赖库的方式有点倒序的意思和Net不一样)顺序如下。

1,点击左下角快捷图标,打开Maven管理工具,如下图:

点击后,右侧会弹出Maven管理工具,如下图:

点击图中红框内的下载按钮,然后弹出浮动窗,在浮动窗内点击第一项Download Source,如下图:

 

然后IDEA下方会出现一个下载进度条,双击进度条可以最大化,里面有详细信息(如果网速很快或者Jar包很小,该进度条可能一闪而过),如下图:

 

最后我们回到实体类,将鼠标放到@Data上,点击Alt+Enter,然后在弹出的浮动窗上点击Import class,然后系统会为我们引入@Data注解所属的Jar包—import lombok.Data;。

现在@Data注解就可以正常运行了,不过,这个过程好像有点。。。

—————————————————————————————————-

回到注解@SpringBootApplication。。。

注解@SpringBootApplication是一个组合注解,包含@SpringBootConfiguration,@EnableAutoConfiguration,@ComponentScan。

@SpringBootConfiguration:将当前类标记为配置类。上文我提到了Java项目里有个web.xml配置文件(类似app.config),不过创建项目时并没有自动生成;其原因就是这个注解了。

Spring框架项目编译时会检测这个注解(组合注解@SpringBootApplication也会被检测),检测到后会把这个类下的函数,全部提取出来,然后在逐个处理; 怎么处理呢?我猜,是通过反射找到函数的函数名,参数,然后执行一下得到返回值;然后把这些字符串组成复合规则的Xml标签,再写进web.xml配置文件。

这样做的好处就是繁琐的XML文件配置,被转化成了代码编写,而且java项目的web.xml最终好像是会被编译进jar,所以这种动态生成web.xml的模式好想也没什么问题。

@EnableAutoConfiguration,@ComponentScan简单理解就是使其他注解生效,如@Controller等;换言之,是使其他注解状态为Enable和为其他注解提供配置信息的注解。

即该注解是其他注解的依赖。。。。。。

—————————————————————————————————-

我们接着看代码,现在到了类的主体代码了,代码如下:

public class ArtifactApplication {

	public static void main(String[] args) {
		SpringApplication.run(ArtifactApplication.class, args);
	} 
}

可以看到,该类是一个拥有Main函数的入口类,类里Main函数主要实现一个功能调用SpringApplication命名空间下的静态方法Run。

我猜测,该方法的主要功能和AspNetCore的 WebHost.CreateDefaultBuilder(args).UseStartup<Startup>().Build();这句话是一个意思,都是启动一个服务器进程。

服务进程启动以后,就可以把我们的Web搭建进去了,我们可以看到Run函数第一个参数就要求主类的类名,这代表服务器启动后,会通过这个入参来启动Web项目。

这里Srping和Core的区别就是Spring启动的服务器是Tomcat,而Core启动的服务器是Kestrel。

创建一个Api

现在Java项目我们已经创建完了,该了解的基础我们也了解了,那么让我们一起创建一个Api,然后运行一下看看效果吧。

首先我们创建一个ApiController的文件夹,然后添加一个HelloController文件,然后编写代码如下:

@RestController
public class HelloController
{
    @RequestMapping(value = "/GetName", method = RequestMethod.GET)
    public String GetName()
    {
        return "我是Kiba518";
    }
    @RequestMapping(value = "/GetAge", method = RequestMethod.GET)
    public int GetAge()
    {
        return 518;
    }
}

可以看到,代码中在类的上面加了一个注解@RestController,该注解表示当前类是一个遵循REST风格的Api类;类似于Net里的Controller继承ApiController。

接着我们创建了两个函数GetName和GetAge;他们的头上使用@RequestMapping注解,该注解的作用是设置访问该函数的地址。

即,函数GetName和GetAge的访问地址为 http://127.0.0.1:8010/GetName和 http://127.0.0.1:8010/GetAge;访问时,我们需要注意,GetName和GetAge这个地址是区分大小写的。。。

现在Shift+F10运行下项目,测试一下我们的WebApi。

 如上图,WebApi访问成功。不过我们访问的端口是8010。

还记得上面说的Spring启动时会创建一个服务器吗,这个端口就是服务器监听的端口。

当然了,这个端口是可配置的,配置的位置就在application.properties里。

不过.properties文件编写和阅读不太方便,我们把他改为.yml,然后修改代码如下:

server:
    port: 8010

这个配置文件里的内容是可以被Java访问的,而且Spring框架项目编译时也会先读这里的内容,找到同名的配置,就会替换默认的配置。

PS:Java中控制访问地址的注解非常多,控制地址访问的模式也非常多,多到有点夸张的地步。。。

结语

从开发工具的角度来看,Java的开发工具的使用相较Net而言,是比较怪异的,因为,它有一些工具的设计和使用是倒序的。

而Java工具又比较多,因此,这种正序工具和倒序工具同时存在同时使用,感觉上就有一点怪,不过习惯了以后倒也没什么。

从开发的角度来看,Java的主流Spring和Net几乎没有什么区别,唯一的区别就是Java使用注解而Net使用继承。

—————————————————————————————————-

代码已经传到Github上了,欢迎大家下载。

Github地址:https://github.com/kiba518/KibaJavaStart

—————————————————————————————————-

注:此文章为原创,任何形式的转载都请联系作者获得授权并注明出处!
若您觉得这篇文章还不错,请点击下方的推荐】,非常感谢!

https://www.cnblogs.com/kiba/p/12052925.html

 

 

版权声明:本文为kiba原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/kiba/p/12052925.html