JSP + IDEA 环境配置指南

写在前面

这是一篇关于 Mac OSJSP 的环境配置指南,不同系统略有差别,但步骤如出一辙。

依赖下载

JDK

Java SE 8下载

进入下载页面,移动到 Java SE Development Kit 8u191 的位置,点击 Accept License Agreement, 在列表中找到 MacOS 对应的 jdk 软件包,点击下载。

下载之后双击.pkg文件即可安装jdk.

安装后,安装目录可以使用以下命令查看:

1
/usr/libexec/java_home -V

结果:

1
2
3
4
Matching Java Virtual Machines (1):
1.8.0_191, x86_64: "Java SE 8" /Library/Java/JavaVirtualMachines/jdk1.8.0_191.jdk/Contents/Home

/Library/Java/JavaVirtualMachines/jdk1.8.0_191.jdk/Contents/Home

之后将其写入环境变量中:

1
vi ~/.bash_profile

1
export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk1.8.0_191.jdk/Contents/Home" # 你的java_home目录

加入到 .bash_profile 最后一行,再用 source .bash_profile 更新环境变量即可.


Tomcat

Tomcat 9

进入下载页面,将页面下滑至 #Binary Distributions,选择 ziptar.gz,下载解压后将其移入 /usr/local 中去。

/usr/local

用户级的程序目录,可以类比为 Windows 系统的 C:/Program Files/

主要用来存放用户手动安装的软件,而不是包管理器安装的默认目录,它和 /usr 目录拥有类似的基本结构。

总而言之,这是一个相对良好的目录结构,对保持软件的有序性比较有帮助,当然你可以选择安装到其他的目录。

使用以下命令将 Tomcat 加入到 /usr/local

1
2
3
4
5
sudo mkdir -p /usr/local # 若目录不存在则创建目录
sudo mv ~/Downloads/apache-tomcat-9.0.12 /usr/local # 将Tomcat剪切至/usr/local
sudo ln -s /usr/local/apache-tomcat-9.0.12 /Library/Tomcat # 创建一个快捷方式指向之前剪切的地方到资源库下的Library目录
sudo chown -R wingsico /Library/Tomcat # 权限授予
sudo chmod +x /Library/Tomcat/bin/*.sh # 授予执行权限,可以在该目录下执行脚本文件

之后执行:

1
/Library/Tomcat/startup.sh

启动服务,打开 就可以看到 Tomcat 的默认首页了.


Mysql

使用到jsp,避免不了与数据库打交道。在这里选择使用 Mysql,免费开源又简单,何乐不为呢。

Mysql Community 下载

直接选择 DMG 格式下载安装即可,和普通mac软件安装一样的步骤。

之后跟着安装步骤一步步走就好了,包括设置数据库密码等操作。

当安装完成之后,数据库是默认启动的,其启动端口为 3306.

但安装之后会发现我们使用 mysql 命令是无效的,显示

1
command not found: mysql

需要添加环境变量:

打开 ~/.bash_profile,填入以下代码:

1
PATH=$PATH:/usr/local/mysql/bin

再执行 source ~/.bash_profile 刷新即可。

至此,所需环境基本配置完毕。


IDEA 环境配置

打开 IDEA,点击 Create New Project

create-project

选择 Java EE 下的 Web Application,然后点击 next

web application

随便取一个 Project name,点击确定

project name

之后便出现了自动生成的项目目录:

directory

接下来进行项目的配置,点击左上角的 File, 选择 Project Structure,点击 Project,选择你的 JDK

choose jdk

选择 modules, 点击 dependencies ,点击左下角的小加号

add dependencies

选择 Libraries

Libraries

选择 Tomcat,点击 Add Selected

Add Selected

确定之后,进入到项目主目录,点击 IDEA 右上角的 configure edit

添加一个 configure,点击左上角的加号

create-project

选择 Tomcat Server -> Local

create-project

进入到配置页面

create-project

修改 Application Server,点击 Configure...,在弹出的窗口的 Tomcat Home 写上之前设置的快捷方式的目录,并点击确定

create-project

之后会发现下方有一个 warning(如果没有就跳过这一步),我们点击 Fix

create-project

点击左上角的加号,选择 Web Application: Exploaded ,选择 Empty ,再修改一下 Name,再点击 Output Layout 右侧的 Artifacts,双击 Artifacts 下的 war 包, 再点击确定就好了

create-project

最后再点击右上角的绿色小三角形来运行项目

create-project

ok,可以看到项目成功的运行在 http://localhost:8080


更多

自动刷新静态资源

在初始情况下,每当我们对 jsp 文件进行修改了之后,都需要重启服务器才能看到效果,这样非常麻烦,有一个很简单的办法就可以使得修改之后直接刷新页面就能看到改动而不需要重启服务器

IDEA 进入项目主目录,在右上角的配置文件下拉框选择 Edit Configurations...,找到 Open frame deactivation 配置项,选择 Update classes and resources 即可

create-project

引入第三方jar包

很多时候我们需要一些第三方插件来提供更方便的功能,就需要引入第三方的jar包,但是,在我们没有使用 maven 作为包管理器的时候,我们该如何去管理第三方插件并且可以在项目内正常使用呢?

  1. 在项目目录的 /WEB-INF/ 创建文件夹 lib
  2. Files -> Project structure -> Libraries,点击加号,选择 java,找到刚才创建的 lib 文件夹,点击 Open, 再弹出的页面中选择 Jar Directory,再确定,再点击 Ok 即可

create-project

做完以上步骤之后,就可以将第三方的 jar 包复制到 lib 目录下,之后在 jsp 代码里就可以正确的使用这些包了。

发布服务

当自己写好了 jsp 代码,要如何去将其部署到服务器上呢,这时候就需要 build war包。

继续回到 Project structure,选择 Artifacts,点击加号,如图选择

create-project

修改 Name 为自定的名字,和之前的操作一样,点击 Output Layout 右侧的 Artifacts,双击 Artifacts 下的 war 包, 再点击确定就好了

create-project

回到项目主页面,选择菜单栏中的 Build,选择 Build Artifacts,选择刚才生成的 war 包,点击 build,即可以在之前设置的目录中找到生成的 war 包 (一般是 out 目录下)

create-project

之后将该 war 包复制到 Tomcat 主目录(该目录为上面设置的 /Library/Tomcat)下的 webapps 目录下即可,通过命令行启动 Tomcat 服务。(注意需要先关闭 idea 的 web 服务)

就可以通过访问 http://localhost:8080/[war包名] 来访问项目了。

create-project


思考

为什么访问项目时不需要输入全路径

答: 因为每一个项目下面都有一份 web.xml,其中 welcome-file-list 下的 welcome-file 属性默认值为 index.jsp/index.html 因此,当访问某一个项目时,自动会去请求该项目下的 index.jspindex.html,无需手动输入全路径。

如何将项目发布在其他目录下

1.首先进入 Tomcatconf 目录下,新建名称为 Catalina 的文件夹

2.进入 Catalina 文件夹下,新建名称为 localhost 的文件夹

3.进入 localhost 文件价下,新建名称为 ROOT.xml(后面解释为何是叫ROOT),ROOT.xml 内容如下:

1
<Context path="" docBase="/xxxx/xxxx/api"  reloadable="false" antiJARLocking="true" antiResourceLocking="false"></Context>

完整路径为:tomcat/conf/Catalina/localhost/ROOT.xml

4.说明:

docBase: 你想设置的tomcat加载项目的路径(注意,该路径不能是 webapps 下的某个路径,否则会出现 404 的问题)

path="" :path设置为空默认覆盖 tomcatROOT 目录,而我们访问访问 ROOT 目录是无需项目名称的,直接localhost:8080 即可。所以第三步中我们新建的 xml 名称为 ROOT.xml 。这样做的目的就是项目url的时候可以隐藏项目名字,避免暴露。

path 也可以设置为自己想要的名字,但是如果这么做,那么第三步中,ROOT.xml 的名字必须和 path 设置的一模一样。且访问项目的时候路径为 localhost:8080/path 里设置的名字,这么做也可以隐藏真实的项目名字.

本文标题:JSP + IDEA 环境配置指南

文章作者:wingsico

发布时间:2018年10月23日 - 17:10

最后更新:2018年10月24日 - 10:10

原始链接:https://wingsico.github.io/2018/10/23/summary-of-jsp-build/

许可协议: 署名-非商业性使用-禁止演绎 4.0 国际 转载请保留原文链接及作者。