文件包含指令include是JSP的另一个指令的标识。通过该指令可以在一个JSP页面中包含另一个JSP页面。不过该指令是静态包含，也就是说被包含的文件中所有内容会被原样包到该JSP页面中，即使被包含的和包含的文件中JSP代码，在包含是也不会被执行。使用include指令，最终将生成一个 文件 ，所以在被包含和被包含的文件中不能用相同名称的变量。

语法：<%@ include file=“path”%>

该指令只有一个file属性，用于指定要包含文件的路径。该路径可以是相对路径，也可以是绝对路径，但不可以是<%= %>表达式所表示的文件。

静态包含<%@ include file = “path”%>







两个jsp文件融为一个被编译了。所以，这两个jsp文件不能有冲突的地方。

动态包含：<JSP:include page=“path”>

区别：

1、语法不同

静态包含：<%@ include file=“path”%>

动态包含：<JSP:include page=“path”>

2、参数传递不同

静态包含不能像包含页面传递 参数

动态包含可以使用jsp:param标签像被包含页面传递参数

3、原理不同

静态包含：先合并再翻译

动态包含：先翻译再合并

[20210428更新]：补充了CMakeList.txt文件中遗漏的include指令内容。

本文主要介绍 CMake 中include指令的用法。

1 概述

引用CMake官网对于include指令的介绍，如下：

Load and run CMake code from a file or module.

include指令的用法如下：

include(<file|module> [OPTIONAL] [RESULT_VARIABLE <VAR>] [NO_POLICY_SCOPE])

Load and run CMake code from the file given. Variable reads and writes access the scope of the caller (dynamic scoping). If OPTIONAL is present, then no error is raised if the file does not exist. If RESULT_VARIABLE is given, the variable will be set to the full filename which has been included or NOTFOUND if it failed.

If a module is specified instead of a file, the file with name <modulename>.cmake is searched first in CMAKE_MODULE_PATH, then in the CMake module directory. There is one exception to this: if the file which calls include() is located itself in the CMake builtin module directory, then first the CMake builtin module directory is searched and CMAKE_MODULE_PATH afterwards. See also policy CMP0017.

See the cmake_policy() command documentation for discussion of the NO_POLICY_SCOPE option.

2 作用

从前面所述，我们知道了include指令用来载入并运行来自于文件或模块的CMake代码。

在这里我们针对一些具体的问题场景，介绍include指令的用法。

2.1 多C++标准版本指定

有时我们会有这样一种需求，在使用同一个外层 CMakeLists.txt 的前提下，每个源码子目录中要求使用的C++标准版本不同，有的源码要求使用c++98标准编译、有的源码要求使用c++11标准编译，这时我们就可以使用include指令来满足这样的需求了。

2.1.1 项目代码结构及内容

在这里，我们使用《CMake介绍及用法示例》中的项目代码结构，并在其基础上做一些改动，改动后的项目代码结构如下：



相比于之前的项目代码结构，我们增加了“cmake_dir3”这个源码目录，同时，修改了最外层的 CMakeLists.txt。

cmake_dir3 中包含的文件列表如下：

[root@node1 /opt/liitdar/mydemos/simples/cmake_test]# l cmake_dir3
total 8
-rw-r--r--. 1 root root 257 Jul 21 14:19 CMakeLists.txt
-rw-r--r--. 1 root root 258 Jul 21 14:19 main.cpp
[root@node1 /opt/liitdar/mydemos/simples/cmake_test]# 


其中，CMakeLists.txt 内容如下：

# 遍历当前路径下的所有源文件，并将其添加到变量DIR_SRCS中
aux_source_directory(. DIR_SRCS)

# 添加名为cmake_test3的可执行文件，该文件会由变量DIR_SRCS中的源文件构建生成
add_executable(cmake_test3 ${DIR_SRCS})


main.cpp 内容如下：

#include <iostream>
#include <string>

using namespace std;

int main()
{
    int a = 100;
    string strTest;

    strTest = to_string(a) + " is a string.";

    cout << "a is: " << a << endl;
    cout << "pszTest is: " << strTest << endl;

    return 0;
}


最外层的 CMakeLists.txt 改动部分（新增了cmake_dir3源码目录）如下：



2.1.2 项目构建

此时，我们对上述项目使用 CMake 进行构建，如下：



从上图中可以看到，项目构建失败了，因为在 cmake_dir3 中存在“to_string”函数，该函数需要在c++11标准下进行编译，而默认使用的都是c++98标准。

2.1.3 解决方案

此时，我们就需要为 cmake_dir3 设置不同的c++标准进行编译了。具体步骤如下：

1. 我们在最外层的 CMakeList.txt 的同级目录下，增加一个文件 set_cxx_norm.cmake，如下：



set_cxx_norm.cmake 的内容如下：

# set c++ norm value, these values will be used for comparision later
set(CXX_NORM_CXX98 1)   # C++98
set(CXX_NORM_CXX03 2)   # C++03
set(CXX_NORM_CXX11 3)   # C++11

# Set the wanted C++ norm
# Adds the good argument to the command line in function of the compiler
macro(set_cxx_norm NORM)
    # Extract c++ compiler --version output
    exec_program(
        ${CMAKE_CXX_COMPILER}
        ARGS --version
        OUTPUT_VARIABLE _compiler_output
    )
    # Keep only the first line
    string(REGEX REPLACE
        "(\n.*$)"
        ""
        cxx_compiler_version "${_compiler_output}"
    )
    # Extract the version number
    string(REGEX REPLACE
        "([^0-9.])|([0-9.][^0-9.])"
        ""
        cxx_compiler_version "${cxx_compiler_version}"
    )

    # Set the specific C++ norm According 'NORM'
    if(${NORM} EQUAL ${CXX_NORM_CXX98})
        add_definitions("-std=c++98")
    elseif(${NORM} EQUAL ${CXX_NORM_CXX03})
        add_definitions("-std=c++03")
    elseif(${NORM} EQUAL ${CXX_NORM_CXX11})
        if(${cxx_compiler_version} VERSION_LESS "4.7.0")
            add_definitions("-std=c++0x")
        else()
            add_definitions("-std=c++11")
        endif()
    endif()

endmacro()


2. 然后，通过修改最外层的 CMakeLists.txt，使用include指令引入set_cxx_norm.cmake文件，就可以在源码目录中设置想要使用的c++标准了。CMakeList.txt 中新增的include指令如下：



3. 最后，修改 cmake_dir3 的CMakeLists.txt文件，新增“要使用c++11标准”的语句，如下：

# 使用c++11标准
set_cxx_norm(${CXX_NORM_CXX11})

完成上述修改后，再次进行项目构建，结果如下：



在上图中我们可以看到，项目构建成功了。此时，cmake_test1 和 cmake_test2 使用的是c++98（默认）标准；而 cmake_test3 使用的是c++11标准。

运行 cmake_test3 程序，结果如下：



上面的运行结果表明，cmake_test3 成功调用了c++11标准的“to_string”函数，将整型转换为字符串类型了。

 

include指令为文件加载指令。
被加载的文件可以是文本文件，html文件，jsp文件。
（1）在myjsp1.jsp文件中的加载文本文件：
myjsp1.jsp文件中的代码：
<%@ page contentType="text/html;charset=GB2312" %>



<html>


<head>


<title>include txt file</title>


</head>


<body>


<%@  include file="a.txt"%>



</body>


</html>




a.txt中的代码：
Hello txt!
（2）在myjsp2.jsp文件中包含html文件：


<%@ page contentType="text/html;charset=GB2312" %>


<html>


<head>


<title>include html file</title>


</head>


<body>


<%@include file="a.html"%>



</body>


</html>


（3）在myjsp3.jsp文件中包含jsp文件：


<%@ page contentType="text/html;charset=GB2312" %>


<html>


<head>


<title>include jsp file</title>


</head>


<body>


<%@include file="a.jsp"%>



</body>


</html>

 JSP include指令与jsp:include动作元素区别



 

JSP include指令

JSP include 指令用于通知 JSP 引擎在翻译当前 JSP 页面时，将其他文件中的内容合并进当前 JSP 页面转换成的 Servlet 源文件中，这种在源文件级别进行引入的方式，称为静态引入，当前 JSP 页面与静态引入的文件紧密结合为一个 Servlet。这些文件可以是 JSP 页面、HTML 页面、文本文件或是一段 Java 代码。其语法格式如下：

<%@ include file="relativeURL|absoluteURL" %>

说明如下：


(1) file 属性指定被包含的文件，不支持任何表达式，例如下面是错误的用法：

<% String f="top.html"; %>
<%@ include file="<%=f %>" %>

(2) 不可以在 file 所指定的文件后接任何参数，如下用法也是错误的：

<%@ include file="top.jsp?name=zyf" %>

(3)如果 file 属性值以“/”开头，将在当前应用程序的根目录下查找文件；如果是以文件名或文件夹名开头，将在当前页面所在的目录下查找文件。

注意：使用 include 指令是以静态方式包含文件，被包含文件将原封不动地插入 JSI 文件中，因此，在所包含的文件中不能使用 <html></html>、<body></body> 标记，否则会因为与原有的 JSP 文件有相同标记而产生错误。另外，因为原文件和被包含文件可以相互访问彼此定义的变量和方法，所以要避免变量和方法在命名上产生冲突。

例如

1、使用 include 指令标记静态插入一个文本文件 Hello.txt，并在当前页面同一个 Web 服务目录中显示“很高兴认识你！Nice to meet you.”，具体操作步骤如下。

Hello.txt 文本文件的代码如下：

<%@ page contentType="text/html;charset=utf-8" %>
很高兴认识你!
Nice to meet you.

创建index.jsp页面，具体代码如下：

<%@ page contentType="text/html;charset=utf-8" %>
<html>
<body>
    <H3>
        <% include file="Hello.txt" %>
    </H3>
</body>
</html>

2、在JSP页面引用date.jsp时间

date.jsp

<%--
  Created by IntelliJ IDEA.
  User: 23369
  Date: 2019/6/3
  Time: 20:26
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@page import="java.util.*,java.text.*" %>
<%
    SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy年MM月dd日--HH时mm分ss秒");
    Date date = new Date();
    out.print(simpleDateFormat.format(date));
%>

index.jsp

<%--
  Created by IntelliJ IDEA.
  User: 23369
  Date: 2019/6/2
  Time: 19:33
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8"
 language="java" import="java.util.*,java.time.*"
 buffer="8kb" errorPage="error.jsp" %>
<html>
  <head>
    <title>$Title$</title>
  </head>
  <body>
  <h1>include指令应用</h1>
  <p>
    <%@include file="date.jsp"%>
  </p>
  <h1>include动作元素应用</h1>
  <jsp:include page="date.jsp" flush="true"></jsp:include>
  </body>
</html>