Web test

From da41717cbfff63c0dc205185322c6a7fd57af870 Mon Sep 17 00:00:00 2001 From: niumoo Date: Mon, 6 Dec 2021 19:10:33 +0800 Subject: [PATCH 001/105] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=20java-9=20?= =?UTF-8?q?=E6=96=B0=E7=89=B9=E6=80=A7=E4=BB=A3=E7=A0=81(https://www.wdbyt?= =?UTF-8?q?e.com/2020/02/jdk/jdk9-feature/)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- core-java-modules/core-java-9/README.md | 6 ++ core-java-modules/core-java-9/pom.xml | 21 ++++++ .../wdbyte/java9/Jdk9CollectionFactory.java | 51 +++++++++++++ .../main/java/com/wdbyte/java9/Jdk9Http.java | 31 ++++++++ .../java/com/wdbyte/java9/Jdk9Interface.java | 37 ++++++++++ .../java/com/wdbyte/java9/Jdk9Stream.java | 71 +++++++++++++++++++ .../src/main/java/module-info.java | 5 ++ 7 files changed, 222 insertions(+) create mode 100644 core-java-modules/core-java-9/README.md create mode 100644 core-java-modules/core-java-9/pom.xml create mode 100644 core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9CollectionFactory.java create mode 100644 core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Http.java create mode 100644 core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Interface.java create mode 100644 core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Stream.java create mode 100644 core-java-modules/core-java-9/src/main/java/module-info.java diff --git a/core-java-modules/core-java-9/README.md b/core-java-modules/core-java-9/README.md new file mode 100644 index 0000000..16a83cc --- /dev/null +++ b/core-java-modules/core-java-9/README.md @@ -0,0 +1,6 @@ +## core-java-9 +当前模块包含 Java 9 新特性相关代码 + +### 相关文章 + +- [Java 9 新特性介绍](https://www.wdbyte.com/2020/02/jdk/jdk9-feature/) \ No newline at end of file diff --git a/core-java-modules/core-java-9/pom.xml b/core-java-modules/core-java-9/pom.xml new file mode 100644 index 0000000..6b2d877 --- /dev/null +++ b/core-java-modules/core-java-9/pom.xml @@ -0,0 +1,21 @@ + + + + core-java-modules + com.wdbyte.core-java-modules + 1.0.0-SNAPSHOT + + 4.0.0 + core-java-9 + 1.0.0-SNAPSHOT + core-java-9 + jar + + + 9 + 9 + + + \ No newline at end of file diff --git a/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9CollectionFactory.java b/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9CollectionFactory.java new file mode 100644 index 0000000..2399cc8 --- /dev/null +++ b/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9CollectionFactory.java @@ -0,0 +1,51 @@ +package com.wdbyte.java9; + +import java.util.*; + +/** + * java 9 - 集合工厂方法 + * 集合工厂方法创建的集合都是不可变只读集合，在改变时会抛出异常。 + * 对于 Set 和 Map 工厂方法常见的,创建时如果有 key 值重复，也会直接抛出异常。 + * 对于 Set 和 Map 工厂方法常见的,每个 JVM 运行周期里遍历的顺序是不定的。 + * + * @author 达西 - 公众号：未读代码 + */ +public class Jdk9CollectionFactory { + + public static void main(String[] args) { + // 工厂方法创建集合 + List stringList = List.of("a", "b", "c", "d"); + Set stringSet = Set.of("a", "b", "c", "d"); + Map stringIntegerMap = Map.of("key1", 1, "key2", 2, "key3", 3); + Map stringIntegerMap2 = Map.ofEntries(Map.entry("key1", 1), Map.entry("key2", 2)); + + // 集合输出 + System.out.println(stringList); + System.out.println(stringSet); + System.out.println(stringIntegerMap); + System.out.println(stringIntegerMap2); + + } + + public void hashCodeOf(){ + // 工厂可以自由创建新的实例或者复用现有实例，所以使用 of 创建的集合，避免 == 或者 hashCode 判断操作 + List stringList = List.of("a", "b", "c", "d"); + List stringList2 = List.of("a", "b", "c", "d"); + System.out.println(stringList.hashCode()); + System.out.println(stringList2.hashCode()); + } + + /** + * jdk 9 之前创建只读集合方式 + */ + public void jdk9Before() { + List arrayList = new ArrayList<>(); + arrayList.add("达西"); + arrayList.add("未读代码"); + // 设置为只读集合 + arrayList = Collections.unmodifiableList(arrayList); + // java.lang.UnsupportedOperationException + // arrayList.add("test"); + // Set,Map 同理 + } +} diff --git a/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Http.java b/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Http.java new file mode 100644 index 0000000..63f6cbd --- /dev/null +++ b/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Http.java @@ -0,0 +1,31 @@ +package com.wdbyte.java9; + +import java.io.IOException; +import java.net.URI; + +//import jdk.incubator.http.HttpClient; +//import jdk.incubator.http.HttpRequest; +//import jdk.incubator.http.HttpResponse; + +/** + * @author 达西 - 公众号：未读代码 + */ +public class Jdk9Http { + + /** + * 只有在使用 JDK9 时才可以放开注释语句，不然找不到类 + * + * @param args + * @throws IOException + * @throws InterruptedException + */ + public static void main(String[] args) throws IOException, InterruptedException { + //HttpClient client = HttpClient.newHttpClient(); + //URI uri = URI.create("http://www.tianqiapi.com/api/xxx"); + //HttpRequest req = HttpRequest.newBuilder(uri).header("User-Agent", "Java").GET().build(); + //HttpResponse resp = client.send(req, HttpResponse.BodyHandler.asString()); + //String body = resp.body(); + //System.out.println(body); + } + +} diff --git a/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Interface.java b/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Interface.java new file mode 100644 index 0000000..fcbfe65 --- /dev/null +++ b/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Interface.java @@ -0,0 +1,37 @@ +package com.wdbyte.java9; + +/** + * @author 达西 - 公众号：未读代码 + */ +public class Jdk9Interface { + public static void main(String[] args) { + ChinaPeople chinaPeople = new ChinaPeople(); + chinaPeople.sleep(); + chinaPeople.eat(); + chinaPeople.doXxx(); + } + +} + +class ChinaPeople implements People { + @Override + public void sleep() { + System.out.println("躺着睡"); + } +} + +interface People { + void sleep(); + + default void eat() { + drink(); + } + + default void doXxx() { + drink(); + } + + private void drink() { + System.out.println("喝水"); + } +} \ No newline at end of file diff --git a/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Stream.java b/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Stream.java new file mode 100644 index 0000000..b8fe9ab --- /dev/null +++ b/core-java-modules/core-java-9/src/main/java/com/wdbyte/java9/Jdk9Stream.java @@ -0,0 +1,71 @@ +package com.wdbyte.java9; + +import java.util.List; +import java.util.Optional; +import java.util.stream.Collectors; +import java.util.stream.IntStream; +import java.util.stream.Stream; + +/** + * * @author 达西 - 公众号：未读代码 + */ +public class Jdk9Stream { + + /** + * takeWhile ,从头开始筛选，遇到不满足的就结束了 + * + * @param args + */ + public static void main(String[] args) { + // takeWhile ,从头开始筛选，遇到不满足的就结束了 + List list1 = List.of(1, 2, 3, 4, 5); + List listResult = list1.stream().takeWhile(x -> x < 3).collect(Collectors.toList()); + System.out.println(listResult); + // takeWhile ,从头开始筛选，遇到不满足的就结束 + List list2 = List.of(1, 2, 3, 4, 3, 0); + List listResult2 = list2.stream().takeWhile(x -> x < 3).collect(Collectors.toList()); + System.out.println(listResult2); + } + + /** + * dropWhile ,从头开始删除，遇到不满足的就结束了 + */ + public void dropWhile() { + // dropWhile ,从头开始删除，遇到不满足的就结束了 + List list1 = List.of(1, 2, 3, 4, 5); + List listResult = list1.stream().dropWhile(x -> x < 3).collect(Collectors.toList()); + System.out.println(listResult); + // dropWhile ,从头开始删除，遇到不满足的就结束 + List list2 = List.of(1, 2, 3, 4, 3, 0); + List listResult2 = list2.stream().dropWhile(x -> x < 3).collect(Collectors.toList()); + System.out.println(listResult2); + } + + /** + * 使用 ofNullable 创建支持 null 的 stream + */ + public void ofNullable() { + Stream stream = Stream.of(1, 2, null); + stream.forEach(System.out::print); + System.out.println(); + // 空指针异常 + // stream = Stream.of(null); + stream = Stream.ofNullable(null); + stream.forEach(System.out::print); + } + + /** + * 重载迭代器 + */ + public void iterate() { + IntStream.iterate(0, x -> x < 10, x -> x + 1).forEach(System.out::print); + } + + /** + * Optional 转 Stream + */ + public void optionalToStream() { + Stream s = Optional.of(1).stream(); + s.forEach(System.out::print); + } +} diff --git a/core-java-modules/core-java-9/src/main/java/module-info.java b/core-java-modules/core-java-9/src/main/java/module-info.java new file mode 100644 index 0000000..4ceb417 --- /dev/null +++ b/core-java-modules/core-java-9/src/main/java/module-info.java @@ -0,0 +1,5 @@ +module net.codingme.feature.jdk9 { + exports com.wdbyte.java9; + //requires jdk.incubator.httpclient; + // 只有在使用 JDK9 时才可以放开上面的注释语句，不然找不到模块 +} \ No newline at end of file From fdf1106e38b435edbe2cb8b410f2909ffb690174 Mon Sep 17 00:00:00 2001 From: niumoo Date: Thu, 23 Dec 2021 22:42:30 +0800 Subject: [PATCH 002/105] =?UTF-8?q?feat:=20Java=20=E4=BB=A3=E7=A0=81?= =?UTF-8?q?=E6=80=A7=E8=83=BD=E6=8F=90=E5=8D=87=E6=8A=80=E5=B7=A7(https://?= =?UTF-8?q?www.wdbyte.com/java/code-5-tips.html)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../core-java-performance-code/README.md | 6 ++ .../core-java-performance-code/pom.xml | 35 +++++++ .../main/java/com/wdbyte/EnumIteration.java | 56 +++++++++++ .../java/com/wdbyte/EnumMapBenchmark.java | 92 +++++++++++++++++++ .../src/main/java/com/wdbyte/HashMapKey.java | 65 +++++++++++++ .../src/main/java/com/wdbyte/HashMapSize.java | 36 ++++++++ .../src/main/java/com/wdbyte/StringInJdk.java | 56 +++++++++++ 7 files changed, 346 insertions(+) create mode 100644 core-java-modules/core-java-performance-code/README.md create mode 100644 core-java-modules/core-java-performance-code/pom.xml create mode 100644 core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/EnumIteration.java create mode 100644 core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/EnumMapBenchmark.java create mode 100644 core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/HashMapKey.java create mode 100644 core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/HashMapSize.java create mode 100644 core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/StringInJdk.java diff --git a/core-java-modules/core-java-performance-code/README.md b/core-java-modules/core-java-performance-code/README.md new file mode 100644 index 0000000..28ac9e0 --- /dev/null +++ b/core-java-modules/core-java-performance-code/README.md @@ -0,0 +1,6 @@ +## core-java-performance-code +当前模块包含代码性能相关代码 + +### 相关文章 + +- [Java 中的 5 个代码性能提升技巧](https://www.wdbyte.com/java/code-5-tips.html) \ No newline at end of file diff --git a/core-java-modules/core-java-performance-code/pom.xml b/core-java-modules/core-java-performance-code/pom.xml new file mode 100644 index 0000000..b998e88 --- /dev/null +++ b/core-java-modules/core-java-performance-code/pom.xml @@ -0,0 +1,35 @@ + + + + core-java-modules + com.wdbyte.core-java-modules + 1.0.0-SNAPSHOT + + 4.0.0 + core-java-performance-code + 1.0.0-SNAPSHOT + jar + + + 1.8 + 1.8 + + + + + + org.openjdk.jmh + jmh-core + 1.33 + + + org.openjdk.jmh + jmh-generator-annprocess + 1.33 + provided + + + + \ No newline at end of file diff --git a/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/EnumIteration.java b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/EnumIteration.java new file mode 100644 index 0000000..c4a708f --- /dev/null +++ b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/EnumIteration.java @@ -0,0 +1,56 @@ +package com.wdbyte; + +import java.util.EnumSet; + +import org.openjdk.jmh.annotations.Benchmark; +import org.openjdk.jmh.annotations.Measurement; +import org.openjdk.jmh.annotations.Scope; +import org.openjdk.jmh.annotations.State; +import org.openjdk.jmh.annotations.Warmup; +import org.openjdk.jmh.infra.Blackhole; + +/** + * 枚举类遍历测试 + * + * @author https://www.wdbyte.com + * @date 2021/12/07 + */ +@State(Scope.Benchmark) +@Warmup(iterations = 3, time = 3) +@Measurement(iterations = 5, time = 3) +public class EnumIteration { + + enum FourteenEnum { + a, b, c, d, e, f, g, + h, i, j, k, l, m, n, + o, p, q, r, s, t, + u, v, w, x, y, z; + + static final FourteenEnum[] VALUES; + static { + VALUES = values(); + } + } + + @Benchmark + public void valuesEnum(Blackhole bh) { + for (FourteenEnum value : FourteenEnum.values()) { + bh.consume(value.ordinal()); + } + } + + @Benchmark + public void enumSetEnum(Blackhole bh) { + for (FourteenEnum value : EnumSet.allOf(FourteenEnum.class)) { + bh.consume(value.ordinal()); + } + } + + @Benchmark + public void cacheEnums(Blackhole bh) { + for (FourteenEnum value : FourteenEnum.VALUES) { + bh.consume(value.ordinal()); + } + } +} + diff --git a/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/EnumMapBenchmark.java b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/EnumMapBenchmark.java new file mode 100644 index 0000000..a0da851 --- /dev/null +++ b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/EnumMapBenchmark.java @@ -0,0 +1,92 @@ +package com.wdbyte; + +import java.util.EnumMap; +import java.util.HashMap; +import java.util.SplittableRandom; +import java.util.UUID; + +import org.openjdk.jmh.annotations.Benchmark; +import org.openjdk.jmh.annotations.Level; +import org.openjdk.jmh.annotations.Measurement; +import org.openjdk.jmh.annotations.Scope; +import org.openjdk.jmh.annotations.Setup; +import org.openjdk.jmh.annotations.State; +import org.openjdk.jmh.annotations.Warmup; +import org.openjdk.jmh.infra.Blackhole; + +@State(Scope.Benchmark) +@Warmup(iterations = 3, time = 3) +@Measurement(iterations = 5, time = 3) +public class EnumMapBenchmark { + + enum AnEnum { + a, b, c, d, e, f, g, + h, i, j, k, l, m, n, + o, p, q, r, s, t, + u, v, w, x, y, z; + } + + /** 要查找的 key 的数量 */ + private static int size = 10000; + /** 随机数种子 */ + private static int seed = 99; + + @State(Scope.Benchmark) + public static class EnumMapState { + private EnumMap map; + private AnEnum[] values; + + @Setup(Level.Trial) + public void setup() { + map = new EnumMap<>(AnEnum.class); + values = new AnEnum[size]; + AnEnum[] enumValues = AnEnum.values(); + SplittableRandom random = new SplittableRandom(seed); + for (int i = 0; i < size; i++) { + int nextInt = random.nextInt(0, Integer.MAX_VALUE); + values[i] = enumValues[nextInt % enumValues.length]; + } + for (AnEnum value : enumValues) { + map.put(value, UUID.randomUUID().toString()); + } + } + } + + @State(Scope.Benchmark) + public static class HashMapState{ + private HashMap map; + private String[] values; + + @Setup(Level.Trial) + public void setup() { + map = new HashMap<>(); + values = new String[size]; + AnEnum[] enumValues = AnEnum.values(); + int pos = 0; + SplittableRandom random = new SplittableRandom(seed); + for (int i = 0; i < size; i++) { + int nextInt = random.nextInt(0, Integer.MAX_VALUE); + values[i] = enumValues[nextInt % enumValues.length].toString(); + } + for (AnEnum value : enumValues) { + map.put(value.toString(), UUID.randomUUID().toString()); + } + } + } + + @Benchmark + public void enumMap(EnumMapState state, Blackhole bh) { + for (AnEnum value : state.values) { + bh.consume(state.map.get(value)); + } + } + + @Benchmark + public void hashMap(HashMapState state, Blackhole bh) { + for (String value : state.values) { + bh.consume(state.map.get(value)); + } + } +} + + diff --git a/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/HashMapKey.java b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/HashMapKey.java new file mode 100644 index 0000000..1fc032e --- /dev/null +++ b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/HashMapKey.java @@ -0,0 +1,65 @@ +package com.wdbyte; + +import java.util.HashMap; +import java.util.Map; +import java.util.UUID; + +import org.apache.commons.lang3.tuple.MutablePair; +import org.apache.commons.lang3.tuple.Pair; +import org.openjdk.jmh.annotations.Benchmark; +import org.openjdk.jmh.annotations.Level; +import org.openjdk.jmh.annotations.Measurement; +import org.openjdk.jmh.annotations.OperationsPerInvocation; +import org.openjdk.jmh.annotations.Scope; +import org.openjdk.jmh.annotations.Setup; +import org.openjdk.jmh.annotations.State; +import org.openjdk.jmh.annotations.Warmup; +import org.openjdk.jmh.infra.Blackhole; + +/** + * @author https://www.wdbyte.com + * @date 2021/12/06 + */ +@State(Scope.Benchmark) +@Warmup(iterations = 3, time = 3) +@Measurement(iterations = 5, time = 3) +public class HashMapKey { + + private int size = 1024; + private Map stringMap; + private Map pairMap; + private String[] prefixes; + private String[] suffixes; + + @Setup(Level.Trial) + public void setup() { + prefixes = new String[size]; + suffixes = new String[size]; + stringMap = new HashMap<>(); + pairMap = new HashMap<>(); + for (int i = 0; i < size; ++i) { + prefixes[i] = UUID.randomUUID().toString(); + suffixes[i] = UUID.randomUUID().toString(); + stringMap.put(prefixes[i] + ";" + suffixes[i], i); + // use new String to avoid reference equality speeding up the equals calls + pairMap.put(new MutablePair(prefixes[i], suffixes[i]), i); + } + } + + @Benchmark + @OperationsPerInvocation(1024) + public void stringKey(Blackhole bh) { + for (int i = 0; i < prefixes.length; i++) { + bh.consume(stringMap.get(prefixes[i] + ";" + suffixes[i])); + } + } + + @Benchmark + @OperationsPerInvocation(1024) + public void pairMap(Blackhole bh) { + for (int i = 0; i < prefixes.length; i++) { + bh.consume(pairMap.get(new MutablePair(prefixes[i], suffixes[i]))); + } + } + +} diff --git a/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/HashMapSize.java b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/HashMapSize.java new file mode 100644 index 0000000..45ed900 --- /dev/null +++ b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/HashMapSize.java @@ -0,0 +1,36 @@ +package com.wdbyte; + +import java.util.HashMap; + +import org.openjdk.jmh.annotations.Benchmark; +import org.openjdk.jmh.annotations.Measurement; +import org.openjdk.jmh.annotations.Param; +import org.openjdk.jmh.annotations.Scope; +import org.openjdk.jmh.annotations.State; +import org.openjdk.jmh.annotations.Warmup; + +/** + * @author https://www.wdbyte.com + * @date 2021/12/06 + */ +@State(Scope.Benchmark) +@Warmup(iterations = 3,time = 3) +@Measurement(iterations = 5,time = 3) +public class HashMapSize { + + @Param({"14"}) + int keys; + + @Param({"16", "32"}) + int size; + + @Benchmark + public HashMap getHashMap() { + HashMap map = new HashMap<>(size); + for (int i = 0; i < keys; i++) { + map.put(i, i); + } + return map; + } + +} diff --git a/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/StringInJdk.java b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/StringInJdk.java new file mode 100644 index 0000000..ee0f6c1 --- /dev/null +++ b/core-java-modules/core-java-performance-code/src/main/java/com/wdbyte/StringInJdk.java @@ -0,0 +1,56 @@ +package com.wdbyte; + +import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.List; +import java.util.UUID; + +import org.openjdk.jmh.annotations.Benchmark; +import org.openjdk.jmh.annotations.Level; +import org.openjdk.jmh.annotations.Measurement; +import org.openjdk.jmh.annotations.Param; +import org.openjdk.jmh.annotations.Scope; +import org.openjdk.jmh.annotations.Setup; +import org.openjdk.jmh.annotations.State; +import org.openjdk.jmh.annotations.Warmup; +import org.openjdk.jmh.infra.Blackhole; + +/** + * @author niulang + * @date 2021/12/23 + */ +@State(Scope.Benchmark) +@Warmup(iterations = 3, time = 3) +@Measurement(iterations = 5, time = 3) +public class StringInJdk { + + @Param({"10000"}) + private int size; + private String[] stringArray; + private List byteList; + + @Setup(Level.Trial) + public void setup() { + byteList = new ArrayList<>(size); + stringArray = new String[size]; + for (int i = 0; i < size; i++) { + String uuid = UUID.randomUUID().toString(); + stringArray[i] = uuid; + byteList.add(uuid.getBytes(StandardCharsets.UTF_8)); + } + } + + @Benchmark + public void byteToString(Blackhole bh) { + for (byte[] bytes : byteList) { + bh.consume(new String(bytes, StandardCharsets.UTF_8)); + } + } + + @Benchmark + public void stringToByte(Blackhole bh) { + for (String s : stringArray) { + bh.consume(s.getBytes(StandardCharsets.UTF_8)); + } + } +} From 723eba69190c1ec99bfba30945166afd90499045 Mon Sep 17 00:00:00 2001 From: niumoo Date: Thu, 23 Dec 2021 22:47:23 +0800 Subject: [PATCH 003/105] =?UTF-8?q?feat:=20Java=20=E4=BB=A3=E7=A0=81?= =?UTF-8?q?=E6=80=A7=E8=83=BD=E6=8F=90=E5=8D=87=E6=8A=80=E5=B7=A7(https://?= =?UTF-8?q?www.wdbyte.com/java/code-5-tips.html)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 ++ core-java-modules/README.md | 14 ++++++++++++-- 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index dbcf7ba..99afeff 100644 --- a/README.md +++ b/README.md @@ -121,6 +121,8 @@ Java 版本任你发，我用 Java 8 。但是多学点这种装x技巧总没错 - 锁的自动优化升级策略 ## 🔍 Java 性能分析 + +- [Java 中的5个代码性能提升技巧，最高提升9.5倍](https://www.wdbyte.com/java/code-5-tips.html) - [使用 JMX 监控和管理 Java 程序](https://www.wdbyte.com/java/jmx.html) - [Java 中的监控与管理原理概述](https://www.wdbyte.com/java/monitoring.html) - [JMH-大厂是如何使用JMH进行Java代码性能测试的？必须掌握！](https://www.wdbyte.com/2020/08/develop/tool-jmh/) diff --git a/core-java-modules/README.md b/core-java-modules/README.md index f5974c1..46cde3c 100644 --- a/core-java-modules/README.md +++ b/core-java-modules/README.md @@ -2,7 +2,15 @@ 当前模块包含 Java 核心代码 ### 相关文章 - +- [Java 17 新功能介绍](https://www.wdbyte.com/java/java-17/) +- [Java 16 新功能介绍](https://www.wdbyte.com/java/java-16/) +- [Java 15 新功能介绍](https://www.wdbyte.com/java/java-15/) +- [Java 14 新特性讲解](https://www.wdbyte.com/java/java-14/) +- [Java 13 新特性讲解](https://www.wdbyte.com/java/java-13/) +- [Java 12 新特性介绍](https://www.wdbyte.com/2020/02/jdk/jdk12-feature/) +- [Java 11 新特性介绍](https://www.wdbyte.com/2020/03/jdk/jdk11-feature/) +- [Java 10 新特性介绍](https://www.wdbyte.com/2020/02/jdk/jdk10-feature/) +- [Java 9 新特性介绍](https://www.wdbyte.com/2020/02/jdk/jdk9-feature/) - [Java 8 函数接口 UnaryOperator ](https://www.wdbyte.com/java8/java8-unaryoperaotr) - [Java 8 函数接口 BiPredicate ](https://www.wdbyte.com/java8/java8-bipredicate) - [Java 8 函数接口 BiFunction ](https://www.wdbyte.com/java8/java8-bifunction/) @@ -18,5 +26,7 @@ - [Java 7 新特性 - 和低效 IO 说再见，Files,Paths,Path 文件操作介绍](https://www.wdbyte.com/2020/09/jdk/jdk7-file-pahs/) - [Java 7 新特性 - 新特性 - 快来补一波 Java 7 语法特性](https://www.wdbyte.com/2020/01/jdk/jdk7-start/) + - [Java 中的监控与管理原理概述](https://www.wdbyte.com/java/monitoring.html) -- [使用 JMX 监控和管理 Java 程序](https://www.wdbyte.com/java/jmx.html) \ No newline at end of file +- [使用 JMX 监控和管理 Java 程序](https://www.wdbyte.com/java/jmx.html) +- [Java 中的 5 个代码性能提升技巧](https://www.wdbyte.com/java/code-5-tips.html) \ No newline at end of file From 24b90f8d24feff3b3c168ed811746653a7df3b8c Mon Sep 17 00:00:00 2001 From: niumoo Date: Sun, 13 Feb 2022 21:08:03 +0800 Subject: [PATCH 004/105] =?UTF-8?q?feat:=20=E5=AD=97=E7=AC=A6=E5=9B=BE?= =?UTF-8?q?=E6=A1=88=EF=BC=8C=E6=88=91=E7=94=A8=E5=AD=97=E7=AC=A6=E7=94=BB?= =?UTF-8?q?=E4=B8=AA=E5=86=B0=E5=A2=A9=E5=A2=A9(https://www.wdbyte.com/jav?= =?UTF-8?q?a/char-image.html)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 1 + core-java-modules/README.md | 4 +- core-java-modules/core-java-io/README.md | 6 + core-java-modules/core-java-io/pom.xml | 21 ++++ .../wdbyte/io/image/GeneratorTextImage.java | 104 ++++++++++++++++++ .../src/main/resources/bingdundun.jpeg | Bin 0 -> 22890 bytes .../core-java-io/src/main/resources/sanli.jpg | Bin 0 -> 136054 bytes .../core-java-io/src/main/resources/tiger.png | Bin 0 -> 46036 bytes 8 files changed, 135 insertions(+), 1 deletion(-) create mode 100644 core-java-modules/core-java-io/README.md create mode 100644 core-java-modules/core-java-io/pom.xml create mode 100644 core-java-modules/core-java-io/src/main/java/com/wdbyte/io/image/GeneratorTextImage.java create mode 100644 core-java-modules/core-java-io/src/main/resources/bingdundun.jpeg create mode 100644 core-java-modules/core-java-io/src/main/resources/sanli.jpg create mode 100644 core-java-modules/core-java-io/src/main/resources/tiger.png diff --git a/README.md b/README.md index 99afeff..867abaf 100644 --- a/README.md +++ b/README.md @@ -142,6 +142,7 @@ Java 版本任你发，我用 Java 8 。但是多学点这种装x技巧总没错 ## ⏳ Java 开发 +- [字符图案，我用字符画个冰墩墩](https://www.wdbyte.com/java/char-image.html) - [Java 中 RMI 的使用](https://www.wdbyte.com/2021/05/java/java-rmi/) - [如何使用 Github Actions 自动抓取每日必应壁纸?](https://www.wdbyte.com/2021/03/bing-wallpaper-github-action/) - [三种骚操作绕过迭代器遍历时的数据修改异常](https://www.wdbyte.com/2021/02/develop/interator-update/) diff --git a/core-java-modules/README.md b/core-java-modules/README.md index 46cde3c..71d406b 100644 --- a/core-java-modules/README.md +++ b/core-java-modules/README.md @@ -29,4 +29,6 @@ - [Java 中的监控与管理原理概述](https://www.wdbyte.com/java/monitoring.html) - [使用 JMX 监控和管理 Java 程序](https://www.wdbyte.com/java/jmx.html) -- [Java 中的 5 个代码性能提升技巧](https://www.wdbyte.com/java/code-5-tips.html) \ No newline at end of file +- [Java 中的 5 个代码性能提升技巧](https://www.wdbyte.com/java/code-5-tips.html) + +- [字符图案，我用字符画个冰墩墩](https://www.wdbyte.com/java/char-image.html) \ No newline at end of file diff --git a/core-java-modules/core-java-io/README.md b/core-java-modules/core-java-io/README.md new file mode 100644 index 0000000..07174d0 --- /dev/null +++ b/core-java-modules/core-java-io/README.md @@ -0,0 +1,6 @@ +## core-java-performance-code +当前模块包含 IO 相关代码 + +### 相关文章 + +- [字符图案，我用字符画个冰墩墩](https://www.wdbyte.com/java/char-image.html) \ No newline at end of file diff --git a/core-java-modules/core-java-io/pom.xml b/core-java-modules/core-java-io/pom.xml new file mode 100644 index 0000000..dfdad77 --- /dev/null +++ b/core-java-modules/core-java-io/pom.xml @@ -0,0 +1,21 @@ + + + + core-java-modules + com.wdbyte.core-java-modules + 1.0.0-SNAPSHOT + + 4.0.0 + core-java-io + 1.0.0-SNAPSHOT + core-java-io + jar + + + 1.8 + 1.8 + + + \ No newline at end of file diff --git a/core-java-modules/core-java-io/src/main/java/com/wdbyte/io/image/GeneratorTextImage.java b/core-java-modules/core-java-io/src/main/java/com/wdbyte/io/image/GeneratorTextImage.java new file mode 100644 index 0000000..986ab3d --- /dev/null +++ b/core-java-modules/core-java-io/src/main/java/com/wdbyte/io/image/GeneratorTextImage.java @@ -0,0 +1,104 @@ +package com.wdbyte.io.image; + +import java.awt.*; +import java.awt.image.BufferedImage; +import java.io.File; +import java.io.IOException; + +import javax.imageio.ImageIO; + +/** + *

+ * 根据图片生成字符图案 + * 1.图片大小缩放 + * 2.遍历图片像素点 + * 3.获取图片像素点亮度 + * 4.匹配字符 + * 5.输出图案 + * + * @website https://www.wdbyte.com + */ +public class GeneratorTextImage { + + public static void main(String[] args) throws Exception { + BufferedImage image = resizeImage("/Users/darcy/Downloads/sanli.jpg", 120); + printImage(image); + } + + /** + * 图片缩放 + * + * @param srcImagePath 图片路径 + * @param targetWidth 目标宽度 + * @return + * @throws IOException + */ + public static BufferedImage resizeImage(String srcImagePath, int targetWidth) throws IOException { + Image srcImage = ImageIO.read(new File(srcImagePath)); + int targetHeight = getTargetHeight(targetWidth, srcImage); + BufferedImage resizedImage = new BufferedImage(targetWidth, targetHeight, BufferedImage.TYPE_INT_RGB); + Graphics2D graphics2D = resizedImage.createGraphics(); + graphics2D.drawImage(srcImage, 0, 0, targetWidth, targetHeight, null); + graphics2D.dispose(); + return resizedImage; + } + + /** + * 图片缩放 + * + * @param srcImagePath 图片路径 + * @param targetWidth 目标宽度 + * @return + * @throws IOException + */ + public static BufferedImage resizeImage2(String srcImagePath, int targetWidth) throws IOException { + Image srcImage = ImageIO.read(new File(srcImagePath)); + int targetHeight = getTargetHeight(targetWidth, srcImage); + Image image = srcImage.getScaledInstance(targetWidth, targetHeight, Image.SCALE_DEFAULT); + BufferedImage bufferedImage = new BufferedImage(targetWidth, targetHeight, BufferedImage.TYPE_INT_RGB); + bufferedImage.getGraphics().drawImage(image, 0, 0, null); + return bufferedImage; + } + + /** + * 根据指定宽度，计算等比例高度 + * + * @param targetWidth 目标宽度 + * @param srcImage 图片信息 + * @return + */ + private static int getTargetHeight(int targetWidth, Image srcImage) { + int targetHeight = srcImage.getHeight(null); + if (targetWidth < srcImage.getWidth(null)) { + targetHeight = Math.round((float)targetHeight / ((float)srcImage.getWidth(null) / (float)targetWidth)); + } + return targetHeight; + } + + /** + * 图片打印 + * + * @param image + * @throws IOException + */ + public static void printImage(BufferedImage image) throws IOException { + final char[] PIXEL_CHAR_ARRAY = {'W', '@', '#', '8', '&', '*', 'o', ':', '.', ' '}; + int width = image.getWidth(); + int height = image.getHeight(); + for (int i = 0; i < height; i++) { + for (int j = 0; j < width; j++) { + int rgb = image.getRGB(j, i); + Color color = new Color(rgb); + int red = color.getRed(); + int green = color.getGreen(); + int blue = color.getBlue(); + // 一个用于计算RGB像素点灰度的公式 + Double grayscale = 0.2126 * red + 0.7152 * green + 0.0722 * blue; + double index = grayscale / (Math.ceil(255 / PIXEL_CHAR_ARRAY.length) + 0.5); + System.out.print(PIXEL_CHAR_ARRAY[(int)(Math.floor(index))]); + } + System.out.println(); + } + } + +} diff --git a/core-java-modules/core-java-io/src/main/resources/bingdundun.jpeg b/core-java-modules/core-java-io/src/main/resources/bingdundun.jpeg new file mode 100644 index 0000000000000000000000000000000000000000..8243a8a745e076f571efcbedfc1611ba50a7c9fe GIT binary patch literal 22890 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%0A@b|>=TI+UK@@|gz@b*9YHQ67`)Tg-WQ0mpgb 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

- * 使用双重校验锁以及volatile关键字确保线程安全的同时兼顾执行效率 - * @author niujinpeng - */ -public class SingletonLayLoadSynDCL { - // 私有化自身类对象 - // private static SingletonLayLoadSynDCL SINGLETON; - private volatile static SingletonLayLoadSynDCL SINGLETON; - // 私有化构造方法 - private SingletonLayLoadSynDCL() {} - - // 使用双重校验锁确保线程安全的同时兼顾执行效率 - public static SingletonLayLoadSynDCL getInstance() { - if (SINGLETON == null) { - synchronized (SingletonLayLoadSynDCL.class) { - if (SINGLETON == null) { - SINGLETON = new SingletonLayLoadSynDCL(); - } - } - } - return SINGLETON; - - } -} -``` - -# 单例模式 - 懒汉模式 - 内部类 -除了使用上面的懒汉模式实现方式之外，在解决多线程问题中，《Effective Java》的作者给出了另外一种保证线程安全且兼顾效率的方式，利用了静态内部类以及类加载特性实现。静态内部类只有在调用时才会加载，而静态属性随着类的加载而加载，类的加载初始化只会有一次。因此保证了获取实例的唯一性。 -具体实现： -``` -package cn.snowflow.pattern.singleton; -/** - *

Hello web

- - -``` -#### 部署web项目 -在eclipse中使用Tomcat进行启动项目 -在已经创建完毕的Tomcat server上右键添加项目，然后进行启动即可 - -![在Eclipse使用Tomcat启动Web项目 here](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/a679a296bfc9d79297f11199958cf153.gif) - -#### 访问web项目 -可以看到项目启动在8080端口，启动完毕，此时可以通过浏览器进行项目访问。 - -http://localhost:8080/web-Test/index.html - -![访问测试](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/57549829bfef115af813a93c64751e4c.jpg) - -此时，在Eclipse中创建部署启动一个Web项目已经完成。 - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/develop/web-base-02.md b/docs/develop/web-base-02.md deleted file mode 100644 index de3ed6b..0000000 --- a/docs/develop/web-base-02.md +++ /dev/null @@ -1,189 +0,0 @@ ---- -title: Web笔记（二）Tomcat 使用总结 -date: 2018-08-23 09:12:31 -url: develop/web/web/base-02 -updated: 2018-08-23 09:12:31 -categories: - - Java 开发 -tags: -- Tomcat -- Java EE ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -![](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/84e22fa4d78bc3eb8ed5109a0beb21f8.jpg) -### Tomcat 介绍 -Tomcat是由Apache软件基金会下属的Jakarta项目开发的一个Servlet容器，按照Sun Microsystems提供的技术规范，实现了对Servlet和JavaServer Page（JSP）的支持，并提供了作为Web服务器的一些特有功能，如Tomcat管理和控制平台、安全域管理和Tomcat阀等。由于Tomcat本身也内含了一个HTTP服务器，它也可以被视作一个单独的Web服务器。但是，不能将Tomcat和Apache HTTP服务器混淆，Apache HTTP服务器是一个用C语言实现的HTTPWeb服务器；这两个HTTP web server不是捆绑在一起的。Apache Tomcat包含了一个配置管理工具，也可以通过编辑XML格式的配置文件来进行配置。（摘录自[Wiki](https://zh.wikipedia.org/wiki/Apache_Tomcat)）([Apache Tomcat](http://tomcat.apache.org/)) - - -### Tomcat 安装 -Tomcat是免费的开源软件，可在直接在官方网站下载。 -[http://tomcat.apache.org/](http://tomcat.apache.org/) -1.可以直接在左侧选择版本： - -![enter image description here](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/ae2daaf8a3849968ec40589cdcc54f4b.jpg) - -2.选择版本后可以在下方进行下载，可以选择下载安装版或者解压版，这里选择了解压版 -tar.gz文件是Linux操作系统下的安装版本 -exe文件是Windows系统下的安装版本 -zip文件是Windows系统下的压缩版本 - -![enter image description here](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/5479a7ba9d098838d3e0fee1d2f05877.jpg) - -3.下载完成后解压缩，得到Tomcat目录， - -![Tomca目录](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/869cfe4d5dc8a32e1e1b7f7723587a53.jpg) - -### Tomcat 的默认端口 - -Tomcat 修改HTTP默认端口，可以直接修改Tomcat 目录下\conf \server.xml文件。默认端口号为8080，修改为想要的端口，重启Tomcat即可。 -```xml - -``` -若要修改成8081端口： -```xml - -``` -### Tomcat 的虚拟目录配置 -什么是虚拟目录呢，简单的说，我们可以根据请求的路径不同，来发布不同的项目。如此形式：我们想要 -在访问http://www.codingme.net/testA 时，进入A项目。 -在访问http://www.codingme.net/testB 时，进入B项目。 -这个时候我们就需要配置虚拟目录来完成这个操作。 -此时的URL：http://www.codingme.net/testA 不是单纯的路径，而是协议域名端口号+WEB应用testA。 -#### 自动映射虚拟目录 -在Tomcat 默认情况下，我们可以看到 %Tomca%\conf \server.xml文件最底部有配置如下： - -```xml - - - - - - -``` -这里Tomcat 默认配置了虚拟主机localhost，基础应用目录webapps，也就是%Tomca%\webapps\ 目录，Tomcat 服务器会自动管理webapps目录下的所有web应用，并把它映射成虚似目录。 -因此在需要配置虚拟目录时我们可以直接把项目复制到webapps 目录下进行发布 -示例： -1. 复制项目到webapps下 - -![复制项目到webapps](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/73a4fd3da0339281189dd33b0b417eba.jpg) -2. 查看test/ index.html 文件内容 - ![Index内容](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/f9501721ef675ded41268e0080ef05bc.jpg) -3. 运行%Tomcat%/bin/startup.bat 启动Tomcat -4. 进行访问测试http://localhost:8080/test/index.html - -![访问测试](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/b6b0c70169fe8297bec33d9f51980a72.jpg) - -注意：http://localhost:8080 会默认访问 webapps/ROOT文件夹中的内容。 - -#### 修改server.xml 映射虚拟目录 - -我们也可以通过在server.xml 文件中的host 元素之间添加配置代码来配置虚拟目录：添加代码如下; - -```xml -Context path="/app" docBase="D:/app" debug="0" reloadable="true" crossContext="true"/> -``` - -![](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/6a0ecaf86e878e286eb489d0b5b673d2.jpg) - -配置中我们配置了访问路径为/app ，项目路径D:/app 因此我们只要把要发布的内容放入D:/app 文件夹中即可。 - 配置完毕后运行%Tomcat%/bin/startup.bat 启动Tomcat，可以通过 -> http://localhost:8080/app/index.html - -访问到D:/app/index.html，需要多个虚拟目录可以直接配置多条配置。 - -注意：若想使用http://localhost:8080 访问项目则需要配置 `path=""` -注意：配置中的path值和docBase中的文件夹名称没有任何关系。 - -#### 在conf /Catalina /localhost 增加xml文件映射虚拟目录 - -博主比较推荐这一种。 -在%Tomcat%/conf/Catalina/localhost目录中，增加配置文件来配置虚拟目录。 -配置文件名称格式为：虚拟目录路径.xml -举个栗子： -在%Tomcat%/conf/Catalina/localhost目录中增加文件 `blog.xml` -写入内容： - -```xml - - - -``` -![Tomcat-localhost](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/1a56a5580ae151d1b7201e11fd04bed8.jpg) - -D盘下blog文件夹中内容： - -![](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/ab3ac58378336d818a7386d18e887eab.jpg) - -`docBase="d:/blog" ` 指定了Web应用存放位置为D盘下blog文件夹中。 -`reloadable="true" `表示当blog文件夹中文件有变化中，自动加载。 -配置完毕启动Tomcat后就可以通过访问到blog文件夹中的内容。 - -> http://localhost:8080/blog - -![](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/5ca799c38a020dbd5ae476420537d3bc.jpg) - -注意：需要多个虚拟目录可以多建立几个配置文件，文件名不能相同。 -注意：若想使用http://localhost:8080 访问项目则需要配置文件名为`ROOT.xml`。 -注意：文件名blog.xml 和配置中d:/blog 没有关系，文件名可以写成其他，如blog111.xml，那么在访问时就要访问http://localhost:8080/blog111 - -### Tomcat 的虚拟主机 - -首先我们先了解虚拟主机的用处，一个虚拟主机也就是一个网站。比如我们`只有一个服务器`，一个服务器上只有一个80端口，我们需要发布两个web项目，那么我们可以使用虚拟目录，把两个项目发布到两个不同的路径之下，但是如果我们有两个不同的域名需要把两个项目对应两个域名，我们就需要配置虚拟主机了。 - -示例：两个域名 -一个是`www.aaaa.com` -一个是 `www.bbbb.com` - -为了实验效果，我们配置C:\Windows\System32\drivers\etc\hosts 文件，添加两行映射。 -``` -127.0.0.1 www.aaaa.com -127.0.0.1 www.bbbb.com -``` -此时我们本机可以使用 localhost / www.aaaa.com / www.bbbb.com 进行访问。 - -配置虚拟主机指定www.aaaa.com访问是的内容。 -1：在server.xml中Engine元素中添加一个host子元素 -```xml - - - -``` -其中的 -1. name表示在访问的域名是www.aaaa.com时会使用此配置。 -1. appBase="d:/aaaa" 指定了项目的发布路径。 - -启动Tomcat后，此时在使用www.aaaa.com进行访问时候，会默认显示d:/aaaa/ROOT中的内容。 - -![](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/c437877b962ffd9aac1f3beb2b9c074c.gif) - -如果存在 d:/aaaa/test，则可以通过http://www.aaaa.com:8080/test 进行访问。 -此时test也就是www.aaaa.com的虚拟目录。 -添加www.bbbb.com 访问同上。 - -### Tomcat 的单例多实例配置 -参考之前文章 -[Linux配置Tomcat的单机多实例](https://www.wdbyte.com/2018/08/develop/install-tomcat-many-instance/) - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/develop/web-base-03.md b/docs/develop/web-base-03.md deleted file mode 100644 index 1bcf2ab..0000000 --- a/docs/develop/web-base-03.md +++ /dev/null @@ -1,348 +0,0 @@ ---- -title: Web笔记（三）Servlet 的类与接口API -date: 2018-09-01 09:58:35 -url: develop/web/web/base-03 -updated: 2018-09-01 09:58:35 -categories: - - Java 开发 -tags: - - Servlet ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -### Servlet 介绍 -Java Servlet 是运行在 Web 服务器或应用服务器上的程序，它是作为来自 Web 浏览器或其他 HTTP 客户端的请求和 HTTP 服务器上的数据库或应用程序之间的中间层。 -使用 Servlet，您可以收集来自网页表单的用户输入，呈现来自数据库或者其他源的记录，还可以动态创建网页。 -Java Servlet 通常情况下与使用 CGI（Common Gateway Interface，公共网关接口）实现的程序可以达到异曲同工的效果。但是相比于 CGI，Servlet 有以下几点优势： - - 性能明显更好。 - - Servlet 在 Web 服务器的地址空间内执行。这样它就没有必要再创建一个单独的进程来处理每个客户端请求。 - - Servlet 是独立于平台的，因为它们是用 Java 编写的。 - - 服务器上的 Java 安全管理器执行了一系列限制，以保护服务器计算机上的资源。因此，Servlet 是可信的。 - - Java 类库的全部功能对 Servlet 来说都是可用的。它可以通过 sockets 和 RMI 机制与 applets、数据库或其他软件进行交互。 - - -### Servlet API -Servlet API 包含两个包，分别是:javax.servlet 与javax.servlet.http包。具体的类与接口结构如下图： - -![](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/68c057bb4390b74f4ebb980719345e2a.jpg) - -Servlet 的运行需要Web 服务器的支持，Web服务器可以通过调用Servlet对象提提供的标准API ，对客户端请求做出处理。 -[官方API](https://tomcat.apache.org/tomcat-5.5-doc/servletapi/) - -#### Servlet 接口 - 定义所有 servlet 都必须实现的方法。 -servlet 是运行在 Web 服务器中的小型 Java 程序。servlet 通常通过 HTTP（超文本传输协议）接收和响应来自 Web 客户端的请求。 -要实现此接口，可以编写一个扩展 javax.servlet.GenericServlet 的一般 servlet，或者编写一个扩展 javax.servlet.http.HttpServlet 的 HTTP servlet。 -此接口定义了初始化 servlet 的方法、为请求提供服务的方法和从服务器移除 servlet 的方法。这些方法称为生命周期方法，它们是按以下顺序调用的： - -1. 构造 servlet，然后使用 init 方法将其初始化。 -2. 处理来自客户端的对 service 方法的所有调用。 -3. 从服务中取出 servlet，然后使用 destroy 方法销毁它，最后进行垃圾回收并终止它。 - -除了生命周期方法之外，此接口还提供了 getServletConfig 方法和 getServletInfo 方法，servlet 可使用前一种方法获得任何启动信息，而后一种方法允许 servlet 返回有关其自身的基本信息，比如作者、版本和版权。 - -Servlet 接口中定义的方法如下： - -```java -//当Servlet将要卸载时由Servlet引擎调用，用于是释放资源 -void destroy() - -//由 servlet 容器调用，指示将该 servlet 放入服务。servlet 容器 -//仅在实例化 servlet 之后调用 init 方法一次。在 servlet 可以接 -//收任何请求之前，init 方法必须成功完成。 -void init(ServletConfig config) throws ServletException - -//由 servlet 容器调用，以允许 servlet 响应某个请求。此方法仅在 -//servlet 的 init() 方法成功完成之后调用。 -void service(ServletRequest req, ServletResponse res) throws ServletException, java.io.IOException - -//返回 ServletConfig 对象，该对象包含此 servlet 的初始化和启动 -//参数。返回的 ServletConfig 对象是传递给 init 方法的对象。此接 -//口的实现负责存储 ServletConfig 对象，以便此方法可以返回该对象。 -//实现此接口的 GenericServlet 类已经这样做了。 -ServletConfig getServletConfig() - -// 返回有关 servlet 的信息，比如作者、版本和版权。。 -String getServletInfo() - -``` - -#### ServletConfig 接口 -由Servlet接口中的Init方法我们可以发现，init方法在做初始化工作的时候会传入ServletConfig类型的参数进行初始化工作， Servlet 容器使用的 ServletConfig配置对象，该对象在初始化期间将信息传递给 Servlet。 - -ServletConfig 接口中定义的方法如下： - -```java -//返回包含指定初始化参数的值的 String，如果参数不存在，则返回 null。 -String getInitParameter(String name) - -//返回一个存储所有初始化变量的枚举函数，如果Servlet没有初始化变量， -//返回一个空的枚举函数 -java.util.Enumeration getInitParameterNames() - -//返回一个ServletConfig 对象的引用 -ServletContext getServletContext() - -//返回此 servlet 实例的名称。该名称可能是通过服务器管理提供的 -//在 Web 应用程序部署描述符中分配，或者对于未注册（和未命名） -//的 servlet 实例，该名称将是该 servlet 的类名称。 -String getServletName() - -``` - -#### GenericServlet 接口 - 定义一般的、与协议无关的 Servlet。要编写用于 Web 上的 HTTP Servlet，请改为扩展 javax.servlet.http.HttpServlet。GenericServlet 实现 Servlet 和 ServletConfig 接口。**实现了Servlet 接口中除service（）方法之外的所有抽象方法，但是是默认实现。**Servlet可以直接扩展 GenericServlet，GenericServlet 使编写 Servlet变得更容易。它提供生命周期方法 init 和 destroy 的简单版本，以及 ServletConfig 接口中的方法的简单版本。GenericServlet 还实现 log 方法，在 ServletContext 接口中对此进行了声明。 - -要编写一般的 servlet，只需重写抽象 service 方法即可。在开发中很少使用，不再说明。 -#### HttpServlet 接口 -HttpServlet 类继承GenericServlet 类，是一个抽象类。在Java Web 开发中自定义Servlet 通常都是直接集成HttpServlet 类，此类实现了Servlet 接口中的service(ServletRequest request,ServletResponse response) 方法，用来处理客户端请求，根据request中的getMethod方法来调用不同的处理方法，例如，get方法，则调用doGet方法进行处理，也因此HttpServlet定义了处理不同请求的不同方法。 - -![](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/7ae09229e2b45fc552e9b2ab3b30d31e.jpg) - - -#### ServletRequest 和 ServletResponse 接口 - 定义将客户端请求信息提供给某个 servlet 的对象。servlet 容器创建 ServletRequest 对象，并将该对象作为参数传递给该 servlet 的 service 方法。 -ServletRequest 对象提供包括参数名称、参数值、属性和输入流的数据。扩展 ServletRequest 的接口可提供其他特定于协议的数据，例如 javax.servlet.http.HttpServletRequest 提供的 HTTP 数据。 - -ServletRequest中有很多有用的方法: -```java -//返回指定servlet上下文（web应用）的URL的前缀。 -String getContextPath() - -//返回请求URI上下文后的子串 -String getServletPath() - -//返回指定的HTTP头标指。如果其由请求给出，则名字应为大小写不敏感。 -String getHeader(String name) - -//返回具有指定名字的请求属性，如果不存在则返回null。属性可由servlet -//引擎设置或使用setAttribute()显式加入。 -Object getAttribute(String name) - -//以指定名称保存请求中指定对象的引用。 -void setAttribute(String name,Object obj) - -//返回指定输入参数，如果不存在，返回null。 -String getParameter(String name) - -//返回请求所用的字符编码。 -String getCharacteEncoding() - -``` -具体可以参考官方API -[ServletRequest API](https://tomcat.apache.org/tomcat-5.5-doc/servletapi/javax/servlet/ServletRequest.html) - -ServletResponse 中有很多有用的方法： -```java -//返回响应使用字符解码的名字。除非显式设置，否则为ISO-8859-1 -String getCharacterEncoding() - -//返回用于将返回的二进制输出写入客户端的流，此方法和getWrite() -//方法二者只能调用其一。 -OutputStream getOutputStream()throws IOException - -//返回用于将返回的文本输出写入客户端的一个字符写入器，此方法和 -//getOutputStream()二者只能调用其一。 -Writer getWriter()throws IOException - -//设置内容类型。在HTTP servlet中即设置Content-Type头标。 -void setContentType(String type) -``` -具体可以参考官方API -[ServletResponse API](https://tomcat.apache.org/tomcat-5.5-doc/servletapi/javax/servlet/ServletResponse.html) - -#### HttpServletRequest 和 HttpServletResponse 接口 -HttpServletRequest 是专用于HTTP的ServletRequest 子接口，客户端浏览器的请求被封装成一个HttpServletRequest 对象，请求信息请求的地址，参数，数据，上传的文件，IP地址，甚至操作系统信息都包含在内。 -主要处理： - -1. 读取和写入HTTP头标 -2. 取得和设置cookies -3. 取得路径信息 -4. 标识HTTP会话。 - -HttpServletRequest 常用方法： -```java -//返回与请求相关cookie的一个数组。 -Cookie[] getCookies() - -//返回HTTP请求方法（例如GET、POST等等） -String getMethod() - - //返回客户端的会话ID -String getRequestedSessionId() - - //调用getSession(true)的简化版。 -HttpSession getSession() - -//返回当前HTTP会话，如果不存在，则创建一个新的会话，create参数为true。 -HttpSession getSession(boolean create) - -//返回URL中一部分，从“/”开始，包括上下文，但不包括任意查询字符串。 -String getRequestURI() - -//返回查询字符串，即URL中?后面的部份。 -String getQueryString() - -//返回指定servlet上下文（web应用）的URL的前缀。 -String getContextPath() -``` -HttpServletResponse 则继承了ServletResponse 接口。都提供了与HTTP有关的方法，主要是对HTTP状态码和Cookie的管理。 -```java -//将一个Set-Cookie头标加入到响应。 -void addCookie(Cookie cookie) - -//设置响应状态码为指定值（可选的状态信息） -void sendError(int status) - -//重定向到某一个Web组件 -void sendRedirect(String location) -``` - -#### ServletContext 接口 -一个ServletContext 接口对象表示一个Web应用程序的上下文，运行在Java虚拟机中每个Web应用程序都有一个与之香瓜你的Servlet上下文，Sevetl API提供了一个ServletContext 接口老表示上下文，它提供了一些方法可以让Servlet 通过这些方法与Servlet 容器进行通信。 -常用方法: -```java -//将对象绑定到此 servlet 上下文中的给定属性名称。若存在，则替换之 -void setAttribute(String name, Object object) - -//返回Servlet 上下文中名字为name的对象，名字是name的对象是全局对象 -//因此可以被同一个Servlet 在任意时候访问，或者上下文中任意其他的Servlet访问 -Object getAttribute(String name) - -// 返回包含指定上下文范围初始化参数值的 String，如果参数不存在，则返回 null -String getInitParameter(String name) -``` -[ServletContext 接口官方API](https://tomcat.apache.org/tomcat-5.5-doc/servletapi/javax/servlet/ServletContext.html) - -#### HttpSession 接口 - 提供一种方式，跨多个页面请求或对 Web 站点的多次访问标识用户并存储有关该用户的信息。 -HttpSession 接口用于记录HTTP客户端和HTTP会话之间的关联，且可以在多个连接和请求中持续一段时间，Session则可以让无状态的HTTP请求在多个请求时识别用户记录状态。 - -此接口允许 servlet -查看和操作有关某个会话的信息，比如会话标识符、创建时间和最后一次访问时间 -将对象绑定到会话，允许跨多个用户连接保留用户信息。 - -常用方法： -```java - -//使此会话无效，然后取消对任何绑定到它的对象的绑定。 -void invalidate() - -//从此会话中移除与指定名称绑定在一起的对象。如果会话没有与 -//指定名称绑定在一起的对象，则此方法不执行任何操作。 -void removeAttribute(String name) - -//使用指定名称将对象绑定到此会话。如果具有同样名称的对象已 -//经绑定到该会话，则替换该对象。 - void setAttribute(String name, Object value) - -//返回与此会话中的指定名称绑定在一起的对象，如果没有对象绑 -//定在该名称下，则返回 null。 - Object getAttribute(String name) - -//返回创建此会话的时间，该时间是用自格林威治标准时间 1970 -//年 1 月 1 日午夜起经过的毫秒数来测量的。 -long getCreationTime() - -//返回包含分配给此会话的唯一标识符的字符串。 -String getId() - -//超时时间以秒为单位。负数则永不超时。 -void setMaxInactiveInterval(int interval) - -//返回 servlet 容器在客户端访问之间将使此会话保持打开状态 -//的最大时间间隔，以秒为单位。 -int getMaxInactiveInterval() -``` - - -### 附录：HttpServletRequest的请求信息获取 - -```java -/** - * HttpServletRequest请求参数获取测试 - * @author niumoo - */ -@WebServlet("/dispense") -public class DispenseServlet extends HttpServlet { - @Override - protected void doGet(HttpServletRequest req, HttpServletResponse resp) - throws ServletException, IOException { - // 获取请求方式：GET - System.out.println("req.getMethod():" + req.getMethod()); - - // 获取项目名称：/dispense - System.out.println("req.getContextPath():" + req.getContextPath()); - - // 获取完整请求路径：http://localhost:8888/dispense/dispense - System.out.println("req.getRequestURL():" + req.getRequestURL()); - - // 获取除了域名外的请求数据：/dispense/dispense - System.out.println("req.getRequestURI():" + req.getRequestURI()); - - // 获取请求参数：name=codingme.net - System.out.println("req.getQueryString():" + req.getQueryString()); - // 获取请求头： - System.out.println("req.getHeader(\"user-Agent\"):" + req.getHeader("user-Agent")); - - System.out.println("-------------------------------------------------"); - // 获取所有的消息头名称 - Enumeration headerNames = req.getHeaderNames(); - // 获取获取的消息头名称，获取对应的值，并输出 - while (headerNames.hasMoreElements()) { - String nextElement = headerNames.nextElement(); - System.out.println(nextElement + ":" + req.getHeader(nextElement)); - } - - System.out.println("---------------------------------------------------"); - // 根据名称获取此重名的所有数据 - System.out.println("req.getHeader(\"accept\"):" + req.getHeader("accept")); - - // 获取请求主机名 - System.out.println("req.getHeader(\"host\"):" + req.getHeader("host")); - - } - - @Override - protected void doPost(HttpServletRequest req, HttpServletResponse resp) - throws ServletException, IOException { - doGet(req, resp); - } -} - -``` -请求：http://localhost:8888/dispense/dispense?name=codingme.net -输出： - -``` -req.getMethod():GET -req.getContextPath():/dispense -req.getRequestURL():http://localhost:8888/dispense/dispense -req.getRequestURI():/dispense/dispense -req.getQueryString():name=codingme.net -req.getHeader("user-Agent"):Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3080.5 Safari/537.36 --------------------------------------------------------- -host:localhost:8888 -connection:keep-alive -cache-control:max-age=0 -upgrade-insecure-requests:1 -user-agent:Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3080.5 Safari/537.36 -accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8 -accept-encoding:gzip, deflate, br -accept-language:zh-CN,zh;q=0.8 -cookie:_ga=GA1.1.1003706294.1499565784; Hm_lvt_57ccbd5c600ed4e6bdb9458e666b6409=1499849256,1499853602,1499950574; Hm_lvt_1b51c3ea9a3e7b1a2bc55df97ab4efd3=1499952403 ----------------------------------------------------------- -req.getHeader("accept"):text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8 -req.getHeader("host"):localhost:8888 -``` - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/develop/web-base-04.md b/docs/develop/web-base-04.md deleted file mode 100644 index c928d93..0000000 --- a/docs/develop/web-base-04.md +++ /dev/null @@ -1,295 +0,0 @@ ---- -title: Web笔记（四）Servlet 程序开发 -date: 2018-09-04 20:35:44 -url: develop/web/web/base-04 -updated: 2018-09-04 20:35:44 -categories: - - Java 开发 -tags: - - Servlet ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - - -### Servlet 的编写 -Servlet本质上是一个Java类，创建一个Servlet很简单，就是定义一个Java类，这个类继承自`javax.servlet.http.HttpServlet`类，覆盖其中的doGet和doPost方法，在doGet和doPost中编写处理请求的代码。 -由于 Servlet 不是 Java 平台标准版的组成部分，所以必须添加jar包：`servlet-api.jar` -可以在Tomcat下lib目录下找到，也可自行下载添加。在创建Web项目的时候如果有选择Tomcat ，则会自动添加，如何创建一个web项目并部署到Tomcat，可以参考之前文章。 -[Web笔记（一） Web 简介与开发环境搭建 -](https://www.wdbyte.com/2018/08/develop/web/web-base-01/) - - -编写第一个Servlet ，我们可以直接在Eclipse 中的Web项目里新建Servelt。 -![创建servlet](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/541e00d4849885d86f4f7795d3c4e1a8.png) - -也可以普通创建类手动继承HttpServlet。在创建完毕后需要手动重写doGet和doPost方法。 -![创建servlet](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/ac0664ef704f0e97e5e657bf849605da.png) - -使用第一种方法新建 FirstServlet.java 类（注意看代码注释） -```java -package net.codingme.servlet; - -import java.io.IOException; -import java.io.PrintWriter; -import javax.servlet.ServletException; -import javax.servlet.annotation.WebServlet; -import javax.servlet.http.HttpServlet; -import javax.servlet.http.HttpServletRequest; -import javax.servlet.http.HttpServletResponse; -/** - * 第一个servlet测试 - * - */ -//@WebServlet("/firstServlet")　 -public class FirstServlet extends HttpServlet { - private static final long serialVersionUID = 1L; - - public FirstServlet() { - super(); - } - - // get请求处理 - protected void doGet(HttpServletRequest request, HttpServletResponse response) - throws ServletException, IOException { - //设置响应的文本类型和字符编码 - response.setContentType("text/html;charset=UTF-8"); - //通过输出流向客户端做出响应 - PrintWriter out = response.getWriter(); - out.println(""); - out.println("
firest servlet
"); - out.println(""); - out.close(); - } - - protected void doPost(HttpServletRequest request, HttpServletResponse response) - throws ServletException, IOException { - doGet(request, response); - } - -} - -``` -HTTP的请求方式除了`get`和`post`请求之外还有put、delete等，get和post是最为常用两种请求方式，所以通常只覆盖doGet和doPost方法。 -`response.setContentType("text/html;charset=UTF-8");`用于设置响应的文本类型和编码方式，通过响应对象获得输出流对象out，用于向客户端浏览器输出响应内容，代码中输出的HTML标记，这实际上是一个动态的Web的页面。 -关于HTTP协议的相关知识可以查看文章[网络协议之HTTP](https://www.wdbyte.com/2018/07/computer/protocol-http/) - - -### Servlet 的web.xml配置 -Servlet编写完成之后，需要在工程`WEBROOT/WEB-INF/web.xml`中进行配置才可以生效，web.xml是Web应用的主配置文件，包含Web应用配置的主要信息。 - -在web.xml中根元素``中配置Servlet，代码如下： -```java - - first - net.codingme.servlet.FirstServlet - - - - first - /firstServlet - -``` -配置解释： -```java - - servlet名 - servlet的class的全名 - - - - servlet名 - servlet的访问路径 - -``` - -### Servlet 3.0的注解配置 - -如果Servlet版本是`3.0`及以上的，可以使用`@WebServlet`注解进行配置，省去了web.xml中的繁琐配置。此方式和通过web.xml配置Servlet`二选一`即可。 - -**@WebServlet主要属性列表** - -| 属性名|类型|描述| -| ------------ | ------------ | ------------ | -| name |String | 指定 Servlet 的 name 属性，等价于。如果没有显式指定，则该 Servlet 的取值即为类的全限定名。 | -| value | String[] | 该属性等价于 urlPatterns 属性。两个属性不能同时使用。 | -| urlPatterns | String[] | 指定一组 Servlet 的 URL 匹配模式。等价于标签。 | -| loadOnStartup | int | 指定 Servlet 的加载顺序，等价于标签。 | -| initParams |WebInitParam[] | 指定一组 Servlet 初始化参数，等价于标签。 | -|asyncSupported |boolean | 声明 Servlet 是否支持异步操作模式，等价于标签。 | -|description |String | 该 Servlet 的描述信息，等价于标签。 | -| displayName |String | 该 Servlet 的显示名，通常配合工具使用，等价于标签。 | - -**@WebServlet完整的使用例子** -```java -@WebServlet(urlPatterns = {"/simple"}, asyncSupported = true, -loadOnStartup = -1, name = "SimpleServlet", displayName = "ss", -initParams = {@WebInitParam(name = "username", value = "tom")} -) - -``` - -只配置访问路径的示例： -```java -package net.codingme.servlet; - -import java.io.IOException; -import java.io.PrintWriter; - -import javax.servlet.ServletException; -import javax.servlet.annotation.WebServlet; -import javax.servlet.http.HttpServlet; -import javax.servlet.http.HttpServletRequest; -import javax.servlet.http.HttpServletResponse; - - -/** - * 第一个servlet测试 - * 使用注解配置访问路径 - */ - @WebServlet(urlPatterns= {"/firstServlet"}) -public class FirstServlet extends HttpServlet { - private static final long serialVersionUID = 1L; - - public FirstServlet() { - super(); - } - . - . - . -``` - -### Servlet 的运行与访问 -Servlet配置完成之后，把Servlet所在工程项目部署到web服务器上并启动。 -发布成功之后可以访问servlet配置的路径进行访问。 -格式如：`协议://服务器地址:端口号/WEB应用名/Servlet的访问路径` -那么web服务器是如何找到对应的servlet类的呢？ -1. 查找web.xml中Servlet配置信息中的``值与请求路径相匹配的项。 -1. 访问到对应的(``中``与``中``值相等，)``，可以访问到指定的Servlet类。 -1. web服务器将在第一次访问servlet时实例化一个servlet对象用于处理请求。 - -访问Servlet有三种方式 - - 直接在浏览器地址中输入访问路径来访问 - - 通过超链接来访问 - - 通过提交表单来访问 - -访问测试： -![访问测试](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/1c8602c60269fa6d2531c00d96d2398c.jpg) - - -### Servlet 的初始化参数 - -自定义的Servlet继承了了HttpServlet，HttpServlet继承了GenericServlet，GenericServlet类实现了ServletConfig接口，所以自定义的Servlet中可以直接使用ServletConfig中的`getInitParameter(String name)`方法。也可直接通过getServletName()方法获得Servlet名字，也就是web.xml中相应的``元素的``的值。如果没有配置会返回Servlet类名。 - - -#### 编写Servlet -```java -package net.codingme.servlet; - -import java.io.IOException; -import java.io.PrintWriter; - -import javax.servlet.ServletException; -import javax.servlet.http.HttpServlet; -import javax.servlet.http.HttpServletRequest; -import javax.servlet.http.HttpServletResponse; - -/** - * - * Servlet获得初始化参数 - * - * @author Niu on 2017年7月25日下午6:14:23 - */ -public class GetInitParamServlet extends HttpServlet { - - @Override - protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { - //通过getInitParameter方法获得配置文件中设置的初始化值 - String name = this.getInitParameter("name"); - String password = this.getInitParameter("password"); - - //通过getServletName方法获得配置文件中设置Servlet名字 - String servletName = this.getServletName(); - - //设置响应文本类型和编码方式 - resp.setContentType("text/html;charset=UTF-8"); - - //通过输出流向客户端做出相应 - PrintWriter out = resp.getWriter(); - out.println("name："+name); - out.println("
"); - out.println("password："+password); - out.println("
"); - out.println("servletName："+servletName); - out.close(); - } - - @Override - protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { - doGet(req, resp); - } - -} -``` - - -#### 配置Servlet -初始化了两个参数，分别是`name：xy`和`password：123`，访问路径/getInitParam - -```xml - - - getInitParam - net.codingme.servlet.GetInitParamServlet - - - name - xy - - - password - 123 - - - - getInitParam - /getInitParam - - -``` - - -#### 测试Servlet -访问配置的路径：http://localhost:8080/servlet-GetInitParam/getInitParam -![访问测试](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/bfad3c21f6258b6bbdfd1d960ca72e74.png) -获取到配置的初始化参数。 - -**GitHub**：[获取初始化参数](https://github.com/niumoo/webcore/tree/master/servlet-GetInitParam) - -### Servlet 的开发总结 -Servlet开发步骤： -1. 编写Servlet，编写一个Java类，继承HttpServlet类并覆盖doGet和doPost方法 -2. 在配置文件web.xml中配置Servlet（Servlet3.0以上版本可以使用注解） -3. 将Servlet所在Java Web项目部署到Web服务器上，例如Tomcat -4. 启动Web服务器 -5. 请求访问Servlet - -Servlet执行流程： -1. 客户端浏览器向Web服务器发送请求访问某一个Servlet -1. Web服务器根据配置信息定位到具体的Servlet -3. 如果这个Servlet是第一次被访问，此时Servlet对象在内存中不存在，则创建这个Servlet对象，如果这个Servlet已经被访问过，则Servlet的对象已经存在内存中，然后创建一个线程操作这个Servlet对象，完成具体功能。 -4. 获得运行结果，通过响应对象（response）设置响应参数并将结果返回到客户端。 -5. 客户端将相应结果显示在浏览器中。 - - -GitHub：[第一个Servlet](https://github.com/niumoo/webcore/tree/master/servlet-First) - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/develop/web-base-05.md b/docs/develop/web-base-05.md deleted file mode 100644 index 63d4a77..0000000 --- a/docs/develop/web-base-05.md +++ /dev/null @@ -1,177 +0,0 @@ ---- -title: Web笔记（五）Servlet 的生命周期 -date: 2018-09-06 20:35:44 -url: develop/web/web/base-05 -updated: 2018-09-06 20:35:44 -categories: - - Java 开发 -tags: - - Servlet - - Java EE ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - - -Servlet的声明周期是由servlet的容器（web服务器）来控制的，通过简单的概括可以分为4步： - -Servlet类加载 → 实例化Servlet → Servlet提供服务 → 销毁Servlet。 - -1. Serlvet 类加载，该阶段仅仅执行一次。 -1. 实例化Servlet ，该阶段仅执行一次、 -1. Servlet 调用 service() 方法来处理客户端的请求，客户端请求一次执行一次，具体的执行次数取决于客户端的请求次数。 -1. Servlet 通过调用 destroy() 方法销毁Servlet，只在web服务器停止服务时执行一次。 - - -### 开发 -通过一个简单的例子来演示Servlet 的生命周期，编写 LiftServlet.java。 -```java -package net.codingme.servlet; - -import javax.servlet.annotation.WebServlet; -import java.io.IOException; - -import javax.servlet.ServletConfig; -import javax.servlet.ServletException; -import javax.servlet.ServletRequest; -import javax.servlet.ServletResponse; -import javax.servlet.http.HttpServlet; -import javax.servlet.http.HttpServletRequest; -import javax.servlet.http.HttpServletResponse; - -/** - * - * Desc：Servlet生命周期测试 - * - * @author niumoo on 2017年7月24日上午11:04:40 - */ -//@WebServlet("/LiftServlet") -public class LiftServlet extends HttpServlet { - - // 不能被覆盖，这里是web服务器的servlet初始化 - @Override - public void init(ServletConfig config) throws ServletException { - System.out.println("Web服务器初始化Servlet : init(ServletConfi confit)"); - super.init(config); - } - - // 可以添加特定的初始化代码 - @Override - public void init() throws ServletException { - System.out.println("初始化init()"); - super.init(); - } - - // 不能被覆盖 - @Override - public void service(ServletRequest arg0, ServletResponse arg1) throws ServletException, IOException { - System.out.println("调用服务：service(ServletRequest arg0, ServletResponse arg1)"); - super.service(arg0, arg1); - } - - // service会检查请求类型，用来判断调用什么方法，不要覆盖 - @Override - protected void service(HttpServletRequest arg0, HttpServletResponse arg1) throws ServletException, IOException { - System.out.println("调用服务：service(HttpServletRequest arg0, HttpServletResponse arg1)"); - super.service(arg0, arg1); - } - - /** - * get方法 - */ - @Override - protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { - System.out.println("GET方法:doGet()"); - resp.getWriter().println("servlet get"); - } - - // 当web服务器正常停止时调用次销毁方法 - @Override - public void destroy() { - System.out.println("销毁：destroy()"); - super.destroy(); - } -} -``` - - -### 配置 -配置web.xml -```xml - - - liftServlet - net.codingme.servlet.LiftServlet - - - liftServlet - /liftServlet - -``` - -代码中配置了LiftServlet 的访问路径为/liftServlet。 - -### 访问 - -访问路径：http://localhost:8080/servlet-LifeCycle/liftServlet - -访问两次链接，观察控制台输出： - -``` -信息: Starting ProtocolHandler ["http-nio-8080"] -八月 06, 2017 11:32:09 上午 org.apache.coyote.AbstractProtocol start -信息: Starting ProtocolHandler ["ajp-nio-8009"] -八月 06, 2017 11:32:09 上午 org.apache.catalina.startup.Catalina start -信息: Server startup in 2705 ms -Web服务器初始化Servlet : init(ServletConfi confit) -初始化init() -调用服务：service(ServletRequest arg0, ServletResponse arg1) -调用服务：service(HttpServletRequest arg0, HttpServletResponse arg1) -GET方法:doGet() -调用服务：service(ServletRequest arg0, ServletResponse arg1) -调用服务：service(HttpServletRequest arg0, HttpServletResponse arg1) -GET方法:doGet() -八月 06, 2017 11:32:42 上午 org.apache.catalina.core.StandardServer await -信息: A valid shutdown command was received via the shutdown port. Stopping the Server instance. -八月 06, 2017 11:32:42 上午 org.apache.coyote.AbstractProtocol pause -信息: Pausing ProtocolHandler ["http-nio-8080"] -八月 06, 2017 11:32:42 上午 org.apache.coyote.AbstractProtocol pause -信息: Pausing ProtocolHandler ["ajp-nio-8009"] -八月 06, 2017 11:32:43 上午 org.apache.catalina.core.StandardService stopInternal -信息: Stopping service [Catalina] -八月 06, 2017 11:32:43 上午 org.apache.catalina.core.ApplicationContext log -信息: SessionListener: contextDestroyed() -八月 06, 2017 11:32:43 上午 org.apache.catalina.core.ApplicationContext log -信息: ContextListener: contextDestroyed() -销毁：destroy() -八月 06, 2017 11:32:43 上午 org.apache.coyote.AbstractProtocol stop -信息: Stopping ProtocolHandler ["http-nio-8080"] -八月 06, 2017 11:32:43 上午 org.apache.coyote.AbstractProtocol stop -信息: Stopping ProtocolHandler ["ajp-nio-8009"] -八月 06, 2017 11:32:43 上午 org.apache.coyote.AbstractProtocol destroy -信息: Destroying ProtocolHandler ["http-nio-8080"] -八月 06, 2017 11:32:43 上午 org.apache.coyote.AbstractProtocol destroy -信息: Destroying ProtocolHandler ["ajp-nio-8009"] -``` - -### 总结 - -1. **servlet初始化**：运行一次，调用`init(ServletConfig config)`创建ServletConfig对象。调用`init()` 创建servlet对象并将两者关联。可以将代码放入init()方法完成特定的初始化工作。 - -1. **servlet服务**：每次请求运行，接收到请求通过`service(ServletRequest arg0, ServletResponse arg1)`方法进行处理，然后把请求对象封装成HttpServletRequest，响应对象封装成HttpServletResponse调用`service(HttpServletRequest arg0, HttpServletResponse arg1)`处理。在这个方法里会根据请求方式调用doGet或者doPost方法进行处理。 - -1. **servlet销毁**：运行一次，销毁Servlet 对象，销毁与之关联的ServletConfig对象， - -可以看到，在第一次访问时调用初始化代码，再次访问只调用服务代码，正常停止Tomcat，调用销毁代码。 - -**GitHub**：[Servlet 生命周期](https://github.com/niumoo/webcore/tree/master/servlet-LifeCycle) - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/elasticsearch/elasticsearch-base-curd.md b/docs/elasticsearch/elasticsearch-base-curd.md deleted file mode 100644 index c12d95f..0000000 --- a/docs/elasticsearch/elasticsearch-base-curd.md +++ /dev/null @@ -1,814 +0,0 @@ ---- -title: 全文搜索ElasticSearch（一）数据的增删改查 -date: 2018-04-16 00:44:28 -url: lucene/elasticsearch-base-curd -tags: -- Elasticsearch -categories: -- Elasticsearch ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -![Elasticsearch logo](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/3d90604a4a775e8ce0450bac9bc4234c.jpg) - -ElasticSearch采用Java编写，提供简单易用的RESTFul API。我们可以直接通过API接口进行操作。 -笔者使用的ElasticSearch版本：elasticsearch-6.3.0 - - - -API基本格式 http://:/<索引>/<类型>/<文档id> -常用的HTTP动词 GET/PUT/POST/DELETE -[RESTFul资料](http://www.ruanyifeng.com/blog/2014/05/restful_api) - -## 索引创建 -### 非结构化创建 -使用Head插件直接点击添加索引创建。 -直接请求创建 $ curl -XPUT http://localhost:9200/book - -### 结构化创建 - -方式1：首先创建book索引 -``` -PUT http://localhost:9200/book。 -``` - -再添加novel类型以及定义结构。 -```json -POST http://localhost:9200/book/novel/_mappings -{ - "novel": { - "properties": { - "title": { - "type": "text" - } - } - } -} -``` - -方式2：直接创建people结构化索引指定配置信息已经数据结构。 -```json -// 创建 -PUT http://localhost:9200/people -{ - "settings":{ - "number_of_shards": 3, - "number_of_replicas": 1 - }, - "mappings":{ - "man":{ - "properties":{ - "name":{ - "type":"text" - }, - "country":{ - "type":"keyword" - }, - "age":{ - "type":"integer" - }, - "date":{ - "type":"date", - "format":"yyyy-MM-dd HH:mm:ss || yyyy-MM-dd || epoch_millis" - } - } - }, - "woman":{ - - } - } -} - -// 响应 -{ - "acknowledged": true, - "shards_acknowledged": true -} - -``` - -### 查看索引信息 - -查询一个索引是否为结构化索引，我们只需要查询索引信息，然后查看mappings属性是否有值，如果为空，则为非结构化索引，如果有相关的属性值，则是结构化索引。下面查看book索引信息： -```json -GET http://localhost:9200/book?pretty=true -{ - "book": { - "aliases": {}, - "mappings": { - "novel": { - "properties": { - "title": { - "type": "text" - } - } - } - }, - "settings": { - "index": { - "creation_date": "1523851142335", - "number_of_shards": "5", - "number_of_replicas": "1", - "uuid": "nbQPVXqqR--eRy_1S3OZqw", - "version": { - "created": "5050199" - }, - "provided_name": "book" - } - } - } -} -``` - -## 数据插入 - -### 根据文档ID插入 -直接POST请求 http://:/<索引>/<类型>/<文档id> -传入JSON数据就可以完成数据插入： -```json -POST http://localhost:9200/people/man/1 -{ - "name":"达西", - "conuntry":"China", - "age":24, - "date":"1994-11-01" -} - -// 响应 -{ - "_index": "people", - "_type": "man", - "_id": "1", - "_version": 1, - "result": "created", - "_shards": { - "total": 2, - "successful": 1, - "failed": 0 - }, - "created": true -} -``` - -### 自动生成文档ID插入 -在发起POST请求的时候，不指定ID的值，ES会自动生成一个ID值。 -```json -POST http://localhost:9200/people/man -{ - "name":"超级玛丽", - "conuntry":"China", - "age":24, - "date":"1994-11-01" -} - -// 响应 -{ - "_index": "people", - "_type": "man", - "_id": "AWLNIi3-QcKhhHA2xN6t", // 自动生成的ID值 - "_version": 1, - "result": "created", - "_shards": { - "total": 2, - "successful": 1, - "failed": 0 - }, - "created": true -} -``` - -## 数据修改 - -### 直接修改 -修改people索引中类型为man的ID为1的文档的name字段值为“曹操” -```json -POST http://localhost:9200/people/man/1/_update -{ - "doc":{ - "name":"曹操" - } -} - -// 响应 -{ - "_index": "people", - "_type": "man", - "_id": "1", - "_version": 5, - "result": "updated", - "_shards": { - "total": 2, - "successful": 1, - "failed": 0 - } -} -``` - -### 脚本修改 -修改people索引中类型为man的ID为1的文档的age字段值为自增10。 -```json -POST http://localhost:9200/people/man/1/_update -{ - "script":{ - "lang":"painless", - "inline":"ctx._source.age+=10" - } -} - -// 响应 -{ - "_index": "people", - "_type": "man", - "_id": "1", - "_version": 9, - "result": "updated", - "_shards": { - "total": 2, - "successful": 1, - "failed": 0 - } -} -``` -另外一种方式 -```json -POST http://localhost:9200/people/man/1/_update -{ - "script":{ - "lang":"painless", - "inline":"ctx._source.age=params.age", - "params":{ - "age":900 - } - } -} -// 响应 -{ - "_index": "people", - "_type": "man", - "_id": "1", - "_version": 10, - "result": "updated", - "_shards": { - "total": 2, - "successful": 1, - "failed": 0 - } -} -``` - -## 删除 - -### 文档删除 -删除people索引中类型为man，ID为1的文档。 -```json -DELETE http://localhost:9200/people/man/1 - -// 响应 -{ - "found": true, - "_index": "people", - "_type": "man", - "_id": "1", - "_version": 11, - "result": "deleted", - "_shards": { - "total": 2, - "successful": 1, - "failed": 0 - } -} -``` - -### 索引删除 -删除people索引 -```json -DELETE http://localhost:9200/people - -// 响应 -{ - "acknowledged": true -} -``` - -## 基本查询 -### 数据准备 -创建book索引，设置结构： - -```json -POST http://localhost:9200/book/novel/_mappings -{ - "novel":{ - "properties":{ - "title":{ - "type":"text" - }, - "author":{ - "type":"text" - }, - "word_count":{ - "type":"integer" - }, - "publish_date":{ - "type":"date", - "format":"yyyy-MM-dd HH:mm:ss || yyyy-MM-dd || epoch_millis" - } - } - } -} - -// 响应 -{ - "acknowledged": true -} - -``` -录入用于测试的数据： -```json -{"title":"超级玛丽秘籍","author":"王五","word_count":5000,"publish_date":"1994-11-01"} -{"title":"三国志","author":"陈寿","word_count":30000,"publish_date":"1995-11-01"} -{"title":"三国演绎","author":"罗贯中","word_count":30000,"publish_date":"1994-03-01"} -{"title":"玛丽与管道工","author":"玛丽","word_count":10000,"publish_date":"1994-03-01"} -{"title":"史记","author":"司马迁","word_count":20000,"publish_date":"1994-08-01"} -{"title":"如何蹦的更高","author":"玛丽","word_count":20000,"publish_date":"1994-08-01"} -``` -## 查询 -### 全部查询 -查询book索引中类型为novel的所有文档信息。 -```json -GET localhost:9200/book/novel/_search?pretty=true - -// 响应 -{ - "took" : 80, // 花费时间 - "timed_out" : false, - "_shards" : { - "total" : 5, - "successful" : 5, - "failed" : 0 - }, - "hits" : { - "total" : 5, //总条数 - "max_score" : 1.0, - "hits" : [ - { - "_index" : "book", - "_type" : "novel", - "_id" : "AWLOAAZzQcKhhHA2xN6z", - "_score" : 1.0, //评分 - "_source" : { - "title" : "超级玛丽秘籍", - "author" : "王五", - "word_count" : 5000, - "publish_date" : "1994-11-01" - } - }, - { - "_index" : "book", - "_type" : "novel", - "_id" : "AWLOAEe5QcKhhHA2xN62", - "_score" : 1.0, - "_source" : { - "title" : "玛丽与管道工", - "author" : "陈寿", - "word_count" : 10000, - "publish_date" : "1994-03-01" - } - }, - { - "_index" : "book", - "_type" : "novel", - "_id" : "AWLOAB8bQcKhhHA2xN60", - "_score" : 1.0, - "_source" : { - "title" : "三国志", - "author" : "陈寿", - "word_count" : 30000, - "publish_date" : "1995-11-01" - } - }, - { - "_index" : "book", - "_type" : "novel", - "_id" : "AWLOADU4QcKhhHA2xN61", - "_score" : 1.0, - "_source" : { - "title" : "三国演绎", - "author" : "罗贯中", - "word_count" : 30000, - "publish_date" : "1994-03-01" - } - }, - { - "_index" : "book", - "_type" : "novel", - "_id" : "AWLOAFiZQcKhhHA2xN63", - "_score" : 1.0, - "_source" : { - "title" : "史记", - "author" : "司马迁", - "word_count" : 20000, - "publish_date" : "1994-08-01" - } - } - ] - } -} - -``` - -### 精确查询 -查询book索引中类型为novel的ID为AWLOAFiZQcKhhHA2xN63的文档信息。 -```json -GET localhost:9200/book/novel/AWLOAFiZQcKhhHA2xN63?pretty=true -// 响应 -{ - "_index" : "book", - "_type" : "novel", - "_id" : "AWLOAFiZQcKhhHA2xN63", - "_version" : 1, - "found" : true, - "_source" : { - "title" : "史记", - "author" : "司马迁", - "word_count" : 20000, - "publish_date" : "1994-08-01" - } -} - -``` - - -### 限制查询条数 -搜索从第一条开始的1条数据。 -```json -POST http://localhost:9200/book/novel/_search -{ - "query":{ - "match_all":{} - }, - "from":1, - "size":1 -} - -// 响应 -{ - "took": 37, - "timed_out": false, - "_shards": { - "total": 5, - "successful": 5, - "failed": 0 - }, - "hits": { - "total": 5, - "max_score": 1, - "hits": [ - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAEe5QcKhhHA2xN62", - "_score": 1, - "_source": { - "title": "玛丽与管道工", - "author": "陈寿", - "word_count": 10000, - "publish_date": "1994-03-01" - } - } - ] - } -} -``` - -### 关键词排序查询 -查询标题里含有“三国”的书籍，并且按出版日期降序排列。 - -```json -POST http://localhost:9200/book/novel/_search -{ - "query":{ - "match":{ - "title":"三国" - } - }, - "sort":[ - { - "publish_date":{"order":"desc"} - } - ] -} - -// 响应 -{ - "took": 200, - "timed_out": false, - "_shards": { - "total": 5, - "successful": 5, - "failed": 0 - }, - "hits": { - "total": 2, - "max_score": 0.34450945, - "hits": [ - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAB8bQcKhhHA2xN60", - "_score": 0.34450945, - "_source": { - "title": "三国志", - "author": "陈寿", - "word_count": 30000, - "publish_date": "1995-11-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOADU4QcKhhHA2xN61", - "_score": 0.34450945, - "_source": { - "title": "三国演绎", - "author": "罗贯中", - "word_count": 30000, - "publish_date": "1994-03-01" - } - } - ] - } -} -``` - -### 聚合查询 -类似于数据库中的分组查询，下面的例子演示按照书籍字数统计数据，按照发布时间统计数量。 -```json -POST http://localhost:9200/book/novel/_search -{ - "aggs":{ - "group_by_word_count":{ - "terms":{ - "field":"word_count" - } - }, - "group_by_author":{ - "terms":{ - "field":"publish_date" - } - } - } - -} -// 响应 -{ - "took": 4, - "timed_out": false, - "_shards": { - "total": 5, - "successful": 5, - "failed": 0 - }, - "hits": { - "total": 5, - "max_score": 1, - "hits": [ - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAAZzQcKhhHA2xN6z", - "_score": 1, - "_source": { - "title": "超级玛丽秘籍", - "author": "王五", - "word_count": 5000, - "publish_date": "1994-11-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAEe5QcKhhHA2xN62", - "_score": 1, - "_source": { - "title": "玛丽与管道工", - "author": "陈寿", - "word_count": 10000, - "publish_date": "1994-03-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAB8bQcKhhHA2xN60", - "_score": 1, - "_source": { - "title": "三国志", - "author": "陈寿", - "word_count": 30000, - "publish_date": "1995-11-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOADU4QcKhhHA2xN61", - "_score": 1, - "_source": { - "title": "三国演绎", - "author": "罗贯中", - "word_count": 30000, - "publish_date": "1994-03-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAFiZQcKhhHA2xN63", - "_score": 1, - "_source": { - "title": "史记", - "author": "司马迁", - "word_count": 20000, - "publish_date": "1994-08-01" - } - } - ] - }, - "aggregations": { - "group_by_word_count": { - "doc_count_error_upper_bound": 0, - "sum_other_doc_count": 0, - "buckets": [ - { - "key": 30000, - "doc_count": 2 - }, - { - "key": 5000, - "doc_count": 1 - }, - { - "key": 10000, - "doc_count": 1 - }, - { - "key": 20000, - "doc_count": 1 - } - ] - }, - "group_by_author": { - "doc_count_error_upper_bound": 0, - "sum_other_doc_count": 0, - "buckets": [ - { - "key": 762480000000, - "key_as_string": "1994-03-01 00:00:00", - "doc_count": 2 - }, - { - "key": 775699200000, - "key_as_string": "1994-08-01 00:00:00", - "doc_count": 1 - }, - { - "key": 783648000000, - "key_as_string": "1994-11-01 00:00:00", - "doc_count": 1 - }, - { - "key": 815184000000, - "key_as_string": "1995-11-01 00:00:00", - "doc_count": 1 - } - ] - } - } -} - -``` - -### 统计查询 -聚合查询也可以用于查询统计信息，下面的例子演示统计书籍字数信息，统计书籍字数最小的字数信息。 -```json -POST http://localhost:9200/book/novel/_search -{ - "aggs":{ - "grades_word_count":{ - "stats":{ - "field":"word_count" - } - }, - "min_word_count":{ - "min":{ - "field":"word_count" - } - } - } - -} -// 响应 -{ - "took": 44, - "timed_out": false, - "_shards": { - "total": 5, - "successful": 5, - "failed": 0 - }, - "hits": { - "total": 5, - "max_score": 1, - "hits": [ - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAAZzQcKhhHA2xN6z", - "_score": 1, - "_source": { - "title": "超级玛丽秘籍", - "author": "王五", - "word_count": 5000, - "publish_date": "1994-11-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAEe5QcKhhHA2xN62", - "_score": 1, - "_source": { - "title": "玛丽与管道工", - "author": "陈寿", - "word_count": 10000, - "publish_date": "1994-03-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAB8bQcKhhHA2xN60", - "_score": 1, - "_source": { - "title": "三国志", - "author": "陈寿", - "word_count": 30000, - "publish_date": "1995-11-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOADU4QcKhhHA2xN61", - "_score": 1, - "_source": { - "title": "三国演绎", - "author": "罗贯中", - "word_count": 30000, - "publish_date": "1994-03-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAFiZQcKhhHA2xN63", - "_score": 1, - "_source": { - "title": "史记", - "author": "司马迁", - "word_count": 20000, - "publish_date": "1994-08-01" - } - } - ] - }, - "aggregations": { - "grades_word_count": { - "count": 5, - "min": 5000, - "max": 30000, - "avg": 19000, - "sum": 95000 - }, - "min_word_count": { - "value": 5000 - } - } -} -``` - - -## 参考资料 -[Elasticsearch Reference](https://www.elastic.co/guide/en/elasticsearch/reference/5.5/index.html) -[Elasticsearch: 权威指南](https://www.elastic.co/guide/cn/elasticsearch/guide/current/index.html) (低版本) - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/elasticsearch/elasticsearch-plug-head.md b/docs/elasticsearch/elasticsearch-plug-head.md deleted file mode 100644 index 7fd948f..0000000 --- a/docs/elasticsearch/elasticsearch-plug-head.md +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: 全文搜索ElasticSearch（三）Head插件的安装与使用 -date: 2018-10-12 19:14:17 -url: lucene/elasticsearch-head -tags: -- Elasticsearch -- 插件 -- Elasticsearch Head -categories: -- Elasticsearch ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - - -![Chrome head安装](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/36fc267332d7fa3aeb1a49fb651c48bc.png) -### elasticsearch-head 介绍 - -`elasticsearch-head`是一个用于浏览器和与`elasticsearch`进行交互的Web前端程序。 `elasticsearch-head`是托管在github上的，可以自由的下载安装使用。 - -GitHub地址：https://github.com/mobz/elasticsearch-head - -### elasticsearch-head 下载 - -head插件可以直接在github页面上点击`clone or download`进行下载然后解压，也可以使用git命令进行下载。 - -`git clone git://github.com/mobz/elasticsearch-head.git` - -### elasticsearch-head 启动 - -#### 方式1：使用nodejs启动 - -这种方式需要使用[nodejs](https://nodejs.org/en/download/)环境进行启动。 - -1. `git clone git://github.com/mobz/elasticsearch-head.git` -1. `cd elasticsearch-head` -1. `npm install` -1. `npm run start` -1. `open` - -#### 方式2：使用Tomcat启动 - -观察解压的`elasticsearch-head` 目录和文件，我们发现head插件只是一个前端页面，因此我们可以运行于任何web服务器，如`Nginx`，`Tomcat`等。因为笔者开发环境是`JDK`，所以使用`Tomcat`进行测试。 -1. 解压Tomcat，进入webapps目录。 -2. 拷贝解压后的head插件内容到`webapps`文件夹。 -![image.png](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/7405907d8c23c444dc105dc6c73997a5.png) -3. Tomcat启动。 -4. `open` http://localhost:8080/elasticsearch-head/ - -这时候如果启动了`elasticsearch`，会发现head插件并不能连接到`elasticsearch`，打开浏览器控制台会发现由于跨域问题产生的错误日志。 -![head跨域错误](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/5a54b9ec54e63d18f4fa3454a04ad548.png) - -这时候我们需要配置`elasticsearch`允许跨域访问，打开`elasticsearch`的配置文件config/elasticsearch.yml在里面添加允许跨域配置。 -``` -# 跨域问题 -http.cors.enabled: true -http.cors.allow-origin: "*" -``` -再次启动`elasticsearch`，会发现`head`可以正常连接到ES了。 - -![head插件](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/4d718cf7b7bba9f61c67cd6f7958b8df.png) - -#### 方式3：使用chrome扩展插件 -此种方式安装的`head`插件，安装简单，没有跨域问题，但是需要可以上`外网`。 - -1. 打开chrome插件地址 [Elasticsearch Head](https://chrome.google.com/webstore/detail/elasticsearch-head/ffmkiejjmecolpfloofpjologoblkegm/) - -2. 点击添加至Chrome - ![Chrome head安装](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/36fc267332d7fa3aeb1a49fb651c48bc.png) -3. 等待安装完毕 -4. 点击chrome扩展中的head图标运行 -![Chrome-Head插件](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/4e8dec7a1910de042607676b3e475796.png) - - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/elasticsearch/elasticsearch-query.md b/docs/elasticsearch/elasticsearch-query.md deleted file mode 100644 index 19b9e65..0000000 --- a/docs/elasticsearch/elasticsearch-query.md +++ /dev/null @@ -1,288 +0,0 @@ ---- -title: 全文搜索ElasticSearch（二）深入搜索 -date: 2018-04-27 15:14:17 -url: lucene/elasticsearch-query -tags: -- Elasticsearch -categories: -- Elasticsearch ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -![全文搜索](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/534fa087bb57ff07a93d9766d1a1b8fa.jpg) -现在，我们已经学会了如何使用 Elasticsearch 作为一个简单的 NoSQL 风格的分布式文档存储系统。我们可以将一个 JSON 文档扔到 Elasticsearch 里，然后根据 ID 检索。但 Elasticsearch 真正强大之处在于可以从无规律的数据中找出有意义的信息——从“大数据”到“大信息”。 - -Elasticsearch 不只会存储（stores）文档，为了能被搜索到也会为文档添加索引（indexes），这也是为什么我们使用结构化的 JSON 文档，而不是无结构的二进制数据。 - -文档中的每个字段都将被索引并且可以被查询。不仅如此，在简单查询时，Elasticsearch 可以使用所有（all）这些索引字段，以惊人的速度返回结果。这是你永远不会考虑用传统数据库去做的一些事情。 - - -笔者使用的ElasticSearch版本：**elasticsearch-5.5.1** -## 数据准备 -```json -{"title":"超级玛丽秘籍","author":"王五","word_count":5000,"publish_date":"1994-11-01"} -{"title":"三国志","author":"陈寿","word_count":30000,"publish_date":"1995-11-01"} -{"title":"三国演绎","author":"罗贯中","word_count":30000,"publish_date":"1994-03-01"} -{"title":"玛丽与管道工","author":"玛丽","word_count":10000,"publish_date":"1994-03-01"} -{"title":"史记","author":"司马迁","word_count":20000,"publish_date":"1994-08-01"} -{"title":"如何蹦的更高","author":"玛丽","word_count":20000,"publish_date":"1994-08-01"} -``` - -## 子条件查询 - -### Query context -在查询过程中，除了判断文档是否满足查询条件外，ES还会计算一个_score来标识匹配的程度，旨在判断目标文档和查询条件匹配的**有多好**。 - -常用查询： -全文本查询，针对**文本类型数据** - -#### 全文本查询-模糊查询 - -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "match":{ - "title":"三国志" - } - } -} -// 响应 -{ - "took": 4, - "timed_out": false, - "_shards": { - "total": 5, - "successful": 5, - "failed": 0 - }, - "hits": { - "total": 2, - "max_score": 0.99938464, - "hits": [ - { - "_index": "book", - "_type": "novel", - "_id": "AWLOAB8bQcKhhHA2xN60", - "_score": 0.99938464, - "_source": { - "title": "三国志", - "author": "陈寿", - "word_count": 30000, - "publish_date": "1995-11-01" - } - }, - { - "_index": "book", - "_type": "novel", - "_id": "AWLOADU4QcKhhHA2xN61", - "_score": 0.34450945, - "_source": { - "title": "三国演绎", - "author": "罗贯中", - "word_count": 30000, - "publish_date": "1994-03-01" - } - } - ] - } -} -``` - -#### 全文本查询-短语查询 -查询书籍名字就是”三国志”的书籍信息。 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "match_phrase":{ - "title":"三国志" - } - } -} - -``` - -#### 全文本查询-多字段查询 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "multi_match":{ - "query":"玛丽", - "fields":["author","title"] - } - } -} -``` -#### 全文本查询-语法查询 -查询“三国”和”演绎”同时匹配的书籍信息或者可以匹配“超级玛丽”的书籍信息。 - -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "query_string":{ - "query":"(三国 AND 演绎) OR 超级玛丽" - } - } -} -``` - -指定字段的语法查询，查询标题中包含三国或者玛丽的书籍信息。 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "query_string":{ - "query":"三国 OR 玛丽", - "fields":["title"] - } - } -} -``` - -字段级别查询，针对结构化数据，如数字，日期等 -#### 字段级别查询-精确查询 -查询书籍字数为10000的书籍信息。 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "term":{ - "word_count":10000 - } - } -} -``` - -#### 字段级别查询-范围查询 -查询书籍字数大于等于10000且小于等于20000的书籍信息，gte中的e是equals，等于的意思。 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "range":{ - "word_count":{ - "gte":10000, - "lte":20000 - } - } - } -} -``` - - -### Filter context -在查询的过程中，只判断该文档是否满足条件，只有YES或者NO的结果。 -使用Filter查询书籍字数为10000的书籍信息。 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "bool":{ - "filter":{ - "term":{ - "word_count":10000 - } - } - } - } -} -``` - -## 复合条件查询 - -### 固定分数查询 -"boost":2用于指定查询出来的信息评分都为2。 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "constant_score":{ - "filter":{ - "match":{ - "title":"三国" - } - }, - "boost":2 - } - } -} -``` -### 组合或关系查询 -查询作者是陈寿或者标题为三国志的书籍信息。 -should表示条件之间是或的关系。 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "bool":{ - "should":[ - { - "match":{ - "author":"陈寿" - } - }, - { - "match":{ - "title":"三国志" - } - } - ] - } - } -} -``` -### 组合与关系查询 -查询作者是陈寿或者标题为三国志的书籍信息。 -Must表示条件之间是且的关系。 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "bool":{ - "must":[ - { - "match":{ - "author":"陈寿" - } - }, - { - "match":{ - "title":"三国志" - } - } - ] - } - } -} -``` - -### 组合非关系查询 -查询作者不是陈寿的书籍信息。 -```json -POST http://localhost:9200/book/_search -{ - "query":{ - "bool":{ - "must_not":{ - "match":{ - "author":"陈寿" - } - } - } - } -} -``` - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/elasticsearch/solr-install.md b/docs/elasticsearch/solr-install.md deleted file mode 100644 index 50ade55..0000000 --- a/docs/elasticsearch/solr-install.md +++ /dev/null @@ -1,204 +0,0 @@ ---- -title: Solr7.3.0入门教程，部署Solr到Tomcat，配置Solr中文分词器 -date: 2018-04-13 17:31:11 -url: lucene/solr-install -tags: -- Solr -- 中文分词 -categories: -- Elasticsearch ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -### solr 基本介绍 - -Apache Solr (读音: SOLer) 是一个开源的搜索服务器。Solr 使用 Java 语言开发，主要基于 HTTP 和 Apache Lucene 实现。Apache Solr 中存储的资源是以 Document 为对象进行存储的。每个文档由一系列的 Field 构成，每个 Field 表示资源的一个属性。Solr 中的每个 Document 需要有能唯一标识其自身的属性，默认情况下这个属性的名字是 id，在 Schema 配置文件中使用：id进行描述。 -Solr是一个高性能，采用Java开发，基于Lucene的全文搜索服务器。文档通过Http利用XML加到一个搜索集合中。查询该集合也是通过 http收到一个XML/JSON响应来实现。它的主要特性包括：高效、灵活的缓存功能，垂直搜索功能，高亮显示搜索结果，通过索引复制来提高可用性，提供一套强大Data Schema来定义字段，类型和设置文本分析，提供基于Web的管理界面等。 - - - -#### solr 名称来源 -Search On Lucene Replication - -#### solr 历史 -2004年 CNET 开发 Solar，为 CNET 提供站内搜索服务 -2006年1月捐献给 Apache ，成为 Apache 的孵化项目 -一年后 Solr 孵化成熟，发布了1.2版，并成为 Lucene 的子项目 -2010年6月，solr 发布了的1.4.1版，这是1.4的 bugfix 版本，1.4.1的solr使用的lucene是2.9版本的 -solr 从1.4.x版本以后，为了保持和lucene同步的版本，solr直接进入3.0版本。 - -### 环境准备 -1. 下载JDK8 安装且配置环境变量 - 可以直接在[JDK官方网站](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)进行下载。 - 安装完毕之后[配置环境变量](https://jingyan.baidu.com/article/c85b7a6414f2ee003bac95d5.html)。 - -2. 下载Solr7.3.0并解压 - 可以直接在[Solr官方网站](https://lucene.apache.org/whoweare.html)进行下载。 - - ![Solr下载](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/fe144bc80396e60b15916c7e51aa7b13.jpg) - http://mirrors.hust.edu.cn/apache/lucene/solr/ - -3. 下载Tomcat 8或者 Tomcat 9 并解压 - 可以直接在[Tomcat官方网站](https://tomcat.apache.org/download-90.cgi)进行下载安装。 - https://tomcat.apache.org/download-90.cgi - - ![Tomcat下载](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/52e69f0e2689f1c02fe0224e27b8c4cc.jpg) - -### 部署Solr到Tomcat -说明：我的解压路径 -``` -#Solr：D:\develop\solr-7.3.0 -#Tomcat：D:\webserver\apache-tomcat-9.0.1 -``` -#### 复制Solr文件到Tomcat -1. 拷贝文件夹 -D:\develop\solr-7.3.0\server\solr-webapp\webapp 到 -D:\webserver\apache-tomcat-9.0.1\webapps\ 下，并且重命名为`solr7.3` -2. 复制D:\develop\solr-7.3.0\server\lib\ext 下的所有Jar包到 -D:\webserver\apache-tomcat-9.0.1\webapps\solr7.3\WEB-INF\lib -3. 复制D:\develop\solr-7.3.0\dist下的 - `solr-dataimporthandler-7.3.0.jar` - `solr-dataimporthandler-extras-7.3.0.jar ` -到D:\webserver\apache-tomcat-9.0.1\webapps\solr7.3\WEB-INF\lib -4. 复制D:\develop\solr-7.3.0\server\lib下的`metrics-`开头的五个Jar -到D:\webserver\apache-tomcat-9.0.1\webapps\solr7.3\WEB-INF\lib -5. 复制D:\develop\solr-7.3.0\server\resources\log4j.properties到 -D:\webserver\apache-tomcat-9.0.1\webapps\solr7.3\WEB-INF\classes -#### 配置Solr Home -1. 新建文件夹D:\develop\solr-7.3.0-home，复制D:\develop\solr-7.3.0\server\solr下的所有内容到D:\develop\solr-7.3.0-home。 -2. 打开D:\webserver\apache-tomcat-9.0.1\webapps\solr7.3\WEB-INF\web.xml -在47行配置SolrHome，用于指定数据存放位置。 -``` - - solr/home - D:\develop\solr-7.3.0-home - java.lang.String - -``` -#### 关闭安全约束 -注释掉D:\webserver\apache-tomcat-9.0.1\webapps\solr7.3\WEB-INF\web.xml最下方的安全约束，让项目启动之后可以正常访问。 - -```xml - - -``` -#### Tomcat启动访问 -至此，Solr配置以及完成，启动Tomcat访问 -http://localhost:8080/solr7.3/index.html - -![Solr7.3首页](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/1f414f595a368a2f1250a068c3f28c92.jpg)) - -### 创建Solr Core -点击网页左侧菜单Core Admin -输入 - name：blog - instanceDir：blog -点击`Add Core`，网页上方提示在D:\develop\solr-7.3.0-home\blog下无法找到solrconfig.xml： - -``` -Error CREATEing SolrCore 'blog': Unable to create core [blog] Caused by: Can't find resource 'solrconfig.xml' in classpath or 'D:\develop\solr-7.3.0-home\blog' -``` -我们复制官方给出的默认配置，复制 -D:\develop\solr-7.3.0-home\configsets\_default\conf -到D:\develop\solr-7.3.0-home\blog下，回到页面，再次点击`Add Core`，等待页面添加成功自动刷新。 -此时，在SolrHome下的blog文件夹下生成了相关文件： - -![Solr core](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/59449d149b6083c5f97b0e928c65661d.jpg) - -### 添加 Core 字段 -#### 在页面上添加 -打开http://localhost:8080/solr7.3/index.html选择左侧菜单`Core Selector` 选择刚才添加的blog，接着选择下面的Schema。可以在出现的页面上填写字段信息name：title，field type：string，然后点击`Add Field`完成添加。 -[Solr中的Field、CopyField、DynamicField与其他Field](https://blog.csdn.net/u011518678/article/details/51871925) -#### 在配置文件中添加 -我们打开文件： -D:\develop\solr-7.3.0-home\blog\conf\managed-schema -搜索title关键词，搜索到如下信息： -``` - -``` -可见，我们刚才在页面添加的字段信息最终会生成此条配置，因此，我们也可以拷贝这个配置更改name值为content就可以完成content字段的添加。 - -配置完成之后点击页面`Core Admin `然后点击`Reload`刷新信息，我们就可以在Schema中查看到content字段。 - -### 添加/更新/查询数据 - -在页面选择blog Core，选择Documents，在Document(s)中输入下面内容进行数据然后点击Submit Document添加数据，如果ID已经存在，则为更新。如果JSON中没有写ID字段，会随机生成ID。 - -``` -{ - "id": "10000", - "title": "Sorl入门教程", - "content": "sorl下载，solr配置，solr启动" -} -``` -提交之后可以看到成功添加信息的反馈。 - -``` -Status: success -Response: -{ - "responseHeader": { - "status": 0, - "QTime": 4 - } -} -``` - -数据已经成功添加，如果需要查询数据可以点击左侧`Query`，点击`Execute Query`查询出刚才添加的数据。 - - -### 中文分词器的使用 - -在已经运行的页面上，选择blog Core，然后选择`Analysis`，输入中国人民，字段类型选择_text_，点击`Analyse Values`可以看到没有中文分词器的结果： - -![没有分词器](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/90dabacb5dbcf838003076e24c6ba71e.jpg) - -下面使用中文分词器，下载ikanalyzer-solr6.5 -解压将`IKAnalyzer.cfg.xml`以及`stopword.dic`解压到 -\apache-tomcat-9.0.1\webapps\solr7.3\WEB-INF\classes - - 解压将里面的两个jar包`ik-analyzer-solr5-5.x.jar`以及`solr-analyzer-ik-5.1.0.jar`解压到 - \apache-tomcat-9.0.1\webapps\solr7.3\WEB-INF\lib - - 打开刚才创建的blog core目录\solr-7.3.0-home\blog\conf，编辑managed-schema文件添加配置： - -``` - - - -``` - -在页面选择Core Admin -> blog -> Reload 刷新配置，然后选择blog Core，然后选择`Analysis`，输入中国人民，字段类型选择text_ik，点击`Analyse Values`可以看到没有中文分词器的结果： - -![使用分词器](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/a57faf42fa5e96435d4ffde6b8a66c0b.jpg) - - -### 参考资料 -[Solr官方文档](https://lucene.apache.org/solr/guide/7_3/solr-tutorial.html) - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/htmlcss/css-mac-window.md b/docs/htmlcss/css-mac-window.md deleted file mode 100644 index 62bda8d..0000000 --- a/docs/htmlcss/css-mac-window.md +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: CSS - 使用CSS实现Mac窗口效果 -date: 2018-08-15 05:42:55 -updated: 2018-08-15 05:42:55 -url: html-css/css-mac-window -categories: -- 前端开发 -tags: -- Css -- Html ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - - -来不及了，直接贴代码。 -### HTML代码 - -```html -
-
-
-
-
-
-
- Wait,i know you
- keep hungry keep foolish
- 苍苍之天不可得久视，堂堂之地不可得久履，道此绝矣！
- 告后世及其孙子，忽忽锡锡，恐见故里，毋负天地，
- 更亡更在，去如舍庐，下敦闾里！人固当死，慎毋敢佞。 -
-
-``` - -### CSS代码 -主要是三个圆点 -```css -.user-bio { - font-size: 14px; - color: #6a737d; -} -.user-bio .user-bio-top { - height: 15px; - background-color: #E3E3E3; - padding: 8px 12px; - border-top-left-radius: 3px; - border-top-right-radius: 3px; -} -.user-bio .user-bio-body { - background-color: #EEEEEE; - width: 100%; - font-size: 13px; - color: #666666; - overflow: auto; - padding: 20px; - font-family: "Source Code Pro", Consolas, Menlo, Monaco, "Courier New", monospace; -} -.user-bio .user-bio-top div{ - float: left; - margin-right: 10px; - width:13px; - height:13px; - background-color:#FF5F57; - border-radius:50px; -} -.user-bio .user-bio-top .circle-yellow{ - float: left; - margin-right: 10px; - width:13px; - height:13px; - background-color:#FFBD2E; - border-radius:50px; -} -.user-bio .user-bio-top .circle-green{ - float: left; - margin-right: 10px; - width:13px; - height:13px; - background-color:#28CA42; - border-radius:50px; -} -``` -### 最终效果 -![MAC-Window-css](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/1f2dd02d503fcd77d79e41a208349c59.jpg) - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/htmlcss/jquery-easing-anchor-animation.md b/docs/htmlcss/jquery-easing-anchor-animation.md deleted file mode 100644 index e92ee26..0000000 --- a/docs/htmlcss/jquery-easing-anchor-animation.md +++ /dev/null @@ -1,136 +0,0 @@ ---- -title: Jquery - 使用jquery-easing.js实现页面锚点平滑滚动 -date: 2018-08-19 08:48:03 -updated: 2018-08-19 08:48:03 -url: html-css/jquery-easing-anchor-animation -categories: -- 前端开发 -tags: -- Css -- Javascript -- 平滑滚动 ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - - -### 使用jquery-easing.js实现页面锚点平滑滚动 - -使用[jquery easing.js](http://gsgd.co.uk/sandbox/jquery/easing/jquery.easing.1.3.js "jquery easing.js")可以实现多动动画效果。 -jquery easing.js中定义了很多种不同的动画效果，动画速度和时间的关系图可以参考此图： - -![](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/f81d0b4842589fcbd4d085cdd7cd64b1.jpg) - - - -使用easeInOutExpo效果示例锚点的平滑滚动效果，直接上代码。 - -### 效果图 - -![平滑滚动](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/4176b134e77e84d73d0fceb55b96b521.gif) - -### HTML代码 -```html - - - - - - 平滑滚动 - - -
1
-
2
-
3
-
4
-
5
-
6
-
7
-
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
- TO P1 - - - - - - - -``` - - -### Anchor-animation.js代码 -```javascript -(function($) { - // Smooth scrolling using jQuery easing - $('a[href*="#"]:not([href="#"])').click(function() { - if (location.pathname.replace(/^\//, '') == this.pathname.replace(/^\//, '') && location.hostname == this.hostname) { - var target = $(this.hash); - target = target.length ? target : $('[name=' + this.hash.slice(1) + ']'); - if (target.length) { - $('html, body').animate({ - scrollTop: target.offset().top - }, 1000, "easeInOutExpo"); - return false; - } - } - }); -})(jQuery); // End of use strict -``` - -### jquery-easing.js代码 -此处因为只使用到了easeInOutExpo方法，所以我删除了其他没有用到的方法，只保留了easeInOutExpo方法。 - -```javascript -jQuery.easing['jswing'] = jQuery.easing['swing']; - -jQuery.extend( jQuery.easing, -{ - def: 'easeOutQuad', - swing: function (x, t, b, c, d) { - //alert(jQuery.easing.default); - return jQuery.easing[jQuery.easing.def](x, t, b, c, d); - }, - - easeInOutExpo: function (x, t, b, c, d) { - if (t==0) return b; - if (t==d) return b+c; - if ((t/=d/2) < 1) return c/2 * Math.pow(2, 10 * (t - 1)) + b; - return c/2 * (-Math.pow(2, -10 * --t) + 2) + b; - } -}); - - -``` - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/java/java-load-balancing.md b/docs/java/java-load-balancing.md deleted file mode 100644 index 3ec146f..0000000 --- a/docs/java/java-load-balancing.md +++ /dev/null @@ -1,280 +0,0 @@ ---- -title: 一篇有趣的负载均衡算法实现 -date: 2020-05-29 07:37:19 -url: algorithm/load-balancing -categories: -- Java 开发 -tags: -- 负载均衡 ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -**负载均衡**（Load balancing）是一种在多个计算机（网络、CPU、磁盘）之间均匀分配资源，以提高资源利用的技术。使用负载均衡可以最大化服务吞吐量，可能最小化响应时间，同时由于使用负载均衡时，会使用多个服务器节点代单点服务，也提高了服务的可用性。 - -负载均衡的实现可以软件可以硬件，硬件如大名鼎鼎的 F5 负载均衡设备，软件如 NGINX 中的负载均衡实现，又如 Springcloud Ribbon 组件中的负载均衡实现。 - -如果看到这里你还不知道负载均衡是干嘛的，那么只能放一张图了，毕竟没图说个啥。 - -![正经的负载均衡示例](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2020/image-20200527075734086.png) - -负载均衡要做到在多次请求下，每台服务器被请求的次数大致相同。但是实际生产中，可能每台机器的性能不同，我们会希望性能好的机器承担的请求更多一些，这也是正常需求。 - -如果这样说下来你看不懂，那我就再举个例子好了，一排可爱的小熊（服务器）站好。 - -![一排要被访问的服务器](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2020/image-20200527082251915.png) - -这时有人（用户）要过来打脸（请求访问）。 - -![用户请求](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2020/image-20200527082442214.png) - -那么怎么样我们才能让这每一个可爱的小熊被打的次数大致相同呢？ - -又或者熊 4 比较胖，抗击打能力是别人的两倍，我们怎么提高熊 4 被打的次数也是别人的两倍呢？ - -又或者每次出手的力度不同，有重有轻，恰巧熊 4 总是承受这种大力度啪啪打脸，熊 4 即将不省熊事，还要继续打它吗？ - -这些都是值的思考的问题。 - -**说了那么多，口干舌燥，我双手已经饥渴难耐了，迫不及待的想要撸起代码了。** - -## 1. 随机访问 - -上面说了，为了负载均衡，我们必须保证多次出手后，熊 1 到熊 4 被打次数均衡。比如使用随机访问法，根据数学上的概率论，随机出手次数越多，每只熊被打的次数就会越相近。代码实现也比较简单，使用一个随机数，随机访问一个就可以了。 - -```java -/** 服务器列表 */ -private static List serverList = new ArrayList<>(); -static { - serverList.add("192.168.1.2"); - serverList.add("192.168.1.3"); - serverList.add("192.168.1.4"); - serverList.add("192.168.1.5"); -} - -/** - * 随机路由算法 - */ -public static String random() { - // 复制遍历用的集合，防止操作中集合有变更 - List tempList = new ArrayList<>(serverList.size()); - tempList.addAll(serverList); - // 随机数随机访问 - int randomInt = new Random().nextInt(tempList.size()); - return tempList.get(randomInt); -} -``` - -因为使用了非线程安全的集合，所以在访问操作时操作的是集合的拷贝，下面几种轮询方式中也是这种思想。 - -写一个模拟请求方法，请求10w次，记录请求结果。 - -```java -public static void main(String[] args) { - HashMap serverMap = new HashMap<>(); - for (int i = 0; i < 20000; i++) { - String server = random(); - Integer count = serverMap.get(server); - if (count == null) { - count = 1; - } else { - count++; - } - // 记录 - serverMap.put(server, count); - } - // 路由总体结果 - for (Map.Entry entry : serverMap.entrySet()) { - System.out.println("IP:" + entry.getKey() + "，次数：" + entry.getValue()); - } -} -``` - -运行得到请求结果。 - -``` -IP:192.168.1.3，次数：24979 -IP:192.168.1.2，次数：24896 -IP:192.168.1.5，次数：25043 -IP:192.168.1.4，次数：25082 -``` - -每台服务器被访问的次数都趋近于 2.5w，有点负载均衡的意思。但是随机毕竟是随机，是不能保证访问次数绝对均匀的。 - -## 2. 轮询访问 - -轮询访问就简单多了，拿上面的熊1到熊4来说，我们一个接一个的啪啪 - 打脸，熊1打完打熊2，熊2打完打熊3，熊4打完打熊1，最终也是实现了被打均衡。但是保证均匀总是要付出代价的，随机访问中需要随机，轮询访问中需要什么来保证轮询呢？ - -```java -/** 服务器列表 */ -private static List serverList = new ArrayList<>(); -static { - serverList.add("192.168.1.2"); - serverList.add("192.168.1.3"); - serverList.add("192.168.1.4"); - serverList.add("192.168.1.5"); -} -private static Integer index = 0; - -/** - * 随机路由算法 - */ -public static String randomOneByOne() { - // 复制遍历用的集合，防止操作中集合有变更 - List tempList = new ArrayList<>(serverList.size()); - tempList.addAll(serverList); - String server = ""; - synchronized (index) { - index++; - if (index == tempList.size()) { - index = 0; - } - server = tempList.get(index);; - } - return server; -} -``` - -由代码里可以看出来，为了保证轮询，必须记录上次访问的位置，为了让在并发情况下不出现问题，还必须在使用位置记录时进行加锁，很明显这种互斥锁增加了性能开销。 - -依旧使用上面的测试代码测试10w次请求负载情况。 - -```java -IP:192.168.1.3，次数：25000 -IP:192.168.1.2，次数：25000 -IP:192.168.1.5，次数：25000 -IP:192.168.1.4，次数：25000 -``` - -## 3. 轮询加权 - -上面演示了轮询方式，还记的一开始提出的熊4比较胖抗击打能力强，可以承受别人2倍的挨打次数嘛？上面两种方式都没有体现出来熊 4 的这个特点，熊 4 窃喜，不痛不痒。但是熊 1 到熊 3 已经在崩溃的边缘，不行，我们必须要让胖着多打，能者多劳，提高整体性能。 - -```java -/** 服务器列表 */ -private static HashMap serverMap = new HashMap<>(); -static { - serverMap.put("192.168.1.2", 2); - serverMap.put("192.168.1.3", 2); - serverMap.put("192.168.1.4", 2); - serverMap.put("192.168.1.5", 4); -} -private static Integer index = 0; - -/** - * 加权路由算法 - */ -public static String oneByOneWithWeight() { - List tempList = new ArrayList(); - HashMap tempMap = new HashMap<>(); - tempMap.putAll(serverMap); - for (String key : serverMap.keySet()) { - for (int i = 0; i < serverMap.get(key); i++) { - tempList.add(key); - } - } - synchronized (index) { - index++; - if (index == tempList.size()) { - index = 0; - } - return tempList.get(index); - } -} -``` - -这次记录下了每台服务器的整体性能，给出一个数值，数值越大，性能越好。可以承受的请求也就越多，可以看到服务器 `192.168.1.5` 的性能为 4，是其他服务器的两倍，依旧 10 w 请求测试。 - -```java -IP:192.168.1.3，次数：20000 -IP:192.168.1.2，次数：20000 -IP:192.168.1.5，次数：40000 -IP:192.168.1.4，次数：20000 -``` - - `192.168.1.5` 承担了 2 倍的请求。 - -## 4. 随机加权 - -随机加权的方式和轮询加权的方式大致相同，只是把使用互斥锁轮询的方式换成了随机访问，按照概率论来说，访问量增多时，服务访问也会达到负载均衡。 - -```java -/** 服务器列表 */ -private static HashMap serverMap = new HashMap<>(); -static { - serverMap.put("192.168.1.2", 2); - serverMap.put("192.168.1.3", 2); - serverMap.put("192.168.1.4", 2); - serverMap.put("192.168.1.5", 4); -} -/** - * 加权路由算法 - */ -public static String randomWithWeight() { - List tempList = new ArrayList(); - HashMap tempMap = new HashMap<>(); - tempMap.putAll(serverMap); - for (String key : serverMap.keySet()) { - for (int i = 0; i < serverMap.get(key); i++) { - tempList.add(key); - } - } - int randomInt = new Random().nextInt(tempList.size()); - return tempList.get(randomInt); -} -``` - -依旧 10 w 请求测试，`192.168.1.5` 的权重是其他服务器的近似两倍， - -```log -IP:192.168.1.3，次数：19934 -IP:192.168.1.2，次数：20033 -IP:192.168.1.5，次数：39900 -IP:192.168.1.4，次数：20133 -``` - -## 5. IP-Hash - -上面的几种方式要么使用随机数，要么使用轮询，最终都达到了请求的负载均衡。但是也有一个很明显的缺点，就是同一个用户的多次请求很有可能不是同一个服务进行处理的，这时问题来了，如果你的服务依赖于 session ，那么因为服务不同， session 也会丢失，不是我们想要的，所以出现了一种根据请求端的 ip 进行哈希计算来决定请求到哪一台服务器的方式。这种方式可以保证同一个用户的请求落在同一个服务上。 - -```java -private static List serverList = new ArrayList<>(); -static { - serverList.add("192.168.1.2"); - serverList.add("192.168.1.3"); - serverList.add("192.168.1.4"); - serverList.add("192.168.1.5"); -} - -/** - * ip hash 路由算法 - */ -public static String ipHash(String ip) { - // 复制遍历用的集合，防止操作中集合有变更 - List tempList = new ArrayList<>(serverList.size()); - tempList.addAll(serverList); - // 哈希计算请求的服务器 - int index = ip.hashCode() % serverList.size(); - return tempList.get(Math.abs(index)); -} -``` - -## 6. 总结 - -上面的四种方式看似不错，那么这样操作下来真的体现了一开始说的负载均衡吗？答案是不一定的。就像上面的最后一个提问。 - -> 又或者每次出手的力度不同，有重有轻，恰巧熊 4 总是承受这种大力度啪啪打脸，熊 4 即将不省熊事，还要继续打它吗？ - -服务器也是这个道理，每次请求进行的操作对资源的消耗可能是不同的。比如说某些操作它对 CPU 的使用就是比较高，也很正常。**所以负载均衡有时不能简单的通过请求的负载来作为负载均衡的唯一依据**。还可以结合服务的当前连接数量、最近响应时间等维度进行总体均衡，总而言之，就是为了达到资源使用的负载均衡。 - - - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/java/java-think-code-standards.md b/docs/java/java-think-code-standards.md deleted file mode 100644 index f4d3338..0000000 --- a/docs/java/java-think-code-standards.md +++ /dev/null @@ -1,159 +0,0 @@ ---- -title: Java 开发的编程噩梦，这些坑你没踩过算我输 -date: 2020-08-07 08:01:01 -url: java/java-code-standards -tags: - - 开发技巧 -categories: - - Java 开发 ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -很多 Java 初学者在开始编程时会出现一些问题，这些问题并不是指某个特定领域的问题，也不是指对某个业务不熟悉而导致的问题，而是对基础知识不够熟悉导致的问题。而就是这些问题让我们编写了一些不够健壮的代码。 -这篇文章会列举几种编程初学者常常出现的一些问题，我相信这些问题多多少少也曾困扰着现在或曾经的你。如果觉得文章不错，不妨点赞分享，让更多人跳过这些开发中的坑。 - -## 随处可见的 Null 值 -我见过很多的代码会把 Null 值作为返回值，当你预期是一个字符串时，意外得到了一个 Null 值；当你预期得到一个 List 时，意外又得到了一个 Null 值，如果你不进行处理，那么你还会意外得到 `NullPointerException`. -就像下面这样。 - -```java -// 情况1 -String userTag = getUserTag(); -if (userTag.equals("admin")) { // NullPointerException - // ... -} - -// 情况2 -List carList = getCarList(); -for (String car : carList) { // NullPointerException - // ... -} - -``` -为了防止这种情况，你可以在 List 返回时给出一个空的集合而不是 Null，如果是字符串，你可以把要确定有值对象放在比较的前面。 - -```java -if ("admin".equals(userTag)) { - // ... -} -// 或者 -if (Objects.equals(userTag,"admin")){ - // ... -} -``` - -## 没有进行空值检查 -可能你考虑到了上面的 Null 值情况，但是在实际处理时没有考虑空值情况，比如字符空串空串 ""，或者集合为空。那么在后续处理时又有可能得到一个 `NullPointerException`. 所以你应该进行空值判断。 -```java -String userTag = getUserTag(); -if (userTag != null && userTag.trim() != "") { - // ... -} - -List carList = getCarList(); -if (carList != null && !carList.isEmpty()) { - // ... -} -``` -## 忽略的异常处理 -异常处理总是一件烦人的事，而忽略异常似乎总有一种吸引人的魔力。我见过像下面这样的代码。 - -```java -try { - List result= request(); - // ... -}catch (Exception e){ - -} -``` - -你没有看错，catch 中没有任何内容，后来出现了问题，看着日志文件一片太平无迹可寻。异常是故意抛出来的，你应该正确处理它们或者继续抛出。而且同时，你该输出一行日志用来记录这个异常，方便以后的问题追踪。 - -## 没有释放资源 - -在读取文件或者请求网络资源时，总是需要进行 close 操作，这很重要，否则可能会阻塞其他线程的使用。但是初学者可能会忘记这一步操作。其实在 Java 7 开始，就提供了 `try-with-resources` 自动关闭资源的特性，只需要把打开的资源放入 `try` 中。 - -```java -try (FileReader fileReader = new FileReader("setting.xml")) { - // fileReader.read(); - // ... -} catch (Exception e) { - e.printStackTrace(); -} -``` -像上面这样，不需要在 `finally` 里手动调用 `fileReader` 的 `close` 方法关闭资源，因为放在 `try` 里的资源调用会在使用完毕时自动调用 `close`. 而且不管是否有异常抛出，这很实用。 - -## ConcuretModificationException - -总有一天你会遇到 `ConcuretModificationException` ，然后开始百度搜索它的解决方式，这个异常最常见的场景是你在遍历一个集合时进行更新操作，比如像下面这样。 -```java -List list = new ArrayList<>(); -list.add("a1"); -list.add("b1"); -list.add("b2"); -list.add("c1"); -for (String s : list) { - if ("b1".equals(s)) { - list.remove(s); - } -} -``` - -这个异常很有用处，因为 ArrayList 不是线程安全的集合，假设你这边一边遍历，另一个线程不断更新，非线程安全集合会导致你的遍历结果不正确，所以这个异常的存在是合理的。同理 HashMap 也是如此，关于 HashMap 之前已经有一篇文章详细介绍了，可以参考 [最通俗易懂的 HashMap 源码分析解读](https://mp.weixin.qq.com/s/q-rWq79HmzPe08gyfOjaIA)。 - -## 缺少注释 - -**准确的注释可以救人于水火**，这点有时候一点也不夸张。虽然说优秀的代码本身就是非常好的注释，但是这实际开发起来，很少发生。注释并不需要你事无巨细的一一记录，但是你该在核心逻辑添加应有的注释，比如复杂逻辑的实现思路，当前逻辑业务需求。某个判断的添加原因，某个异常的发生情况等等。这可以让你在未来的某一天需要回看现在的代码时感谢自己。更可以**让你在某天的甩锅中轻松胜出**。 - -## 不进行代码测试 - -我见过有些同事在功能开发完毕后直接扔给对接同事使用，而自己却没有经过任何测试，或者只是测试了某个简单的情况。测试是开发过程中的重要环节，没有经过严格测试的代码很难说没有问题，我觉得在功能开发完毕后至少需要**单元测试**，**特殊用例**测试，**集成测试**以及其他形式的测试。**严格的测试不仅可以第一时间发现问题，更可以减少后面不必要的对接调试时间**。 - -## 重复造轮子 - -你知道的，Java 社区非常活跃，存在着大量的第三方类库，开源作者可能花费了数年时间去维护和完善类库，这些类库非常优秀。同时 JDK 也提供了大量的常用的功能封装。这些都可以**为我们的开发速度插上翅膀**。所以，当你需要一个功能时候，应该首先看下 JDK 和已经引入的类库中是否已经存在相同功能，而不是自己重复造轮子，而且大部分情况下你造的轮子还不如别人好。 - -下面举些例子。 - -- 你需要日志记录，可以使用 logback. -- 你需要网络操作，可以使用 netty. -- 你需要解析 JSON，可以使用 gson. -- 你需要解析表格，可以使用 apache poi. -- 你需要通用操作，可以使用 apache commons. - -另外一种情况是，你可能不知道某个功能在 JDK 中已经实现，这时候你应该多多查看 JDK Document. 我就在工作中见到过同事手写字符串 split，为了获取时间戳把 Date 对象转换到 Calendar. - -## 缺少必要的沟通 - -这个部分是和开发没有关系的，但是这个环节往往会影响最终的开发结果。进行具体的开发之前，你应该详细的沟通并理解功能的需求，这样你才能针对具体的需求写出不偏离实际需要的代码。有时候你很有可能因为缺少必要的沟通，错误了理解了需求，最终在开发完毕后发现自己写的功能完全没有用处。 - -## 没有代码规范 - -代码规范性非常重要，如果一个项目里充斥着各种稀奇古怪的代码规范，会让维护者十分头疼。而且软件行业高速发展，对开发者的综合素质要求也越来越高，优秀的编程习惯也可以提高软件的最终质量。比如：标新立异的命名风格挑战阅读习惯；五花八门的错误码人为地增加排查问题的难度；工程结构混乱导致后续项目维护艰难；没有鉴权的漏洞代码易被黑客攻击；质量低下的代码上线之后漏洞百出等等。因为没有统一的代码规范，开发中的问题可能层出不穷。 - -下面简单列举些应该统一的开发规范。如**命名风格如何是好；常量名称结构怎样；代码格式怎么统一；日期时间格式如何处理；集合处理注意事项；日志打印有无规范；前后交互具体规约**等。 - -上面所说的开发规范代码规范推荐阿里推出的《**Java 开发手册**》，里面详细列举了在 Java 开发中各个方面应该遵守的规约和规范。最新版本在 8月 3日已经发布，可以在公众号 “**未读代码**” 直接回复 "java " **获取最新版 pdf.** - -## 总结 - -Bug 和技术上的误解都是美丽的谜团，福尔摩斯般的我们终将解决这些问题。命运自己掌握，每一次探清的这些技术误解，都会增加我们对开发编码的理解。**尽情接招吧，色彩斑斓才有趣，万般体验才是人生，不管是多样的技术，还是多样的问题，我都想看见。** - - - -**参考：** - -[1] [A beginner’s guide to Java programming nightmares](https://jaxenter.com/java-programming-nightmares-156749.html) - -[2] [Java™ Platform, Standard Edition 8 API Specification](https://docs.oracle.com/javase/8/docs/api/) - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/jdk/java-07-feature.md b/docs/jdk/java-07-feature.md deleted file mode 100644 index a650b6a..0000000 --- a/docs/jdk/java-07-feature.md +++ /dev/null @@ -1,462 +0,0 @@ ---- -title: 还看不懂同事代码？快来补一波 Java 7 语法特性 -# toc: false -date: 2020-01-08 08:01:01 -url: jdk/jdk7-start -tags: - - Java7 - - AutoCloseable -categories: - - Java 新特性 ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -# 前言 - -Java 平台自出现到目前为止，已经 20 多个年头了，这 20 多年间 Java 也一直作为最流行的程序设计语言之一，不断面临着其他新兴编程语言的挑战与冲击。Java 语言是一种**静态强类型**语言，这样的语言特性可以让 Java 编译器在**编译阶段**发现错误，这对于构建出一个**稳定安全且健壮**的应用来说，尤为重要。但是也因为这种特性，让 Java 开发似乎变得缺少灵活性，开发某些功能的应用时，代码量可能是其他语言的几倍。Java 开发的不足之处也体现越来越复杂的 JDK 上，越来越复杂的 JDK 让开发者完全理解的难度变的非常大。以至于开发者有时会重复实现一个 JDK 中已经提供了的功能。 - -为了跟上互联网应用编程发展的脚步， Java 从 9 版本开始调整了 JDK 发布的节奏，JDK 的每次更新都注重**提高生产效率**，提高 **JVM 性能**，推行**模块化**等，让开发者可以更多的专注于业务本身，而不是浪费过多的时间在语言特性上。 Java 语言的更新要在语言的严谨性和灵活性上找到一个平衡点，毕竟灵活性可以减少编码的复杂度，而严谨性是构建复杂且健壮应用的基石。 - -# Java 7 语言特性 - -Java 重要的更新版本是在 Java 5 版本，这个版本中增加了如泛型、增强 for、自动装箱拆箱、枚举类型，可变参数、注解等一系列**重要功能**，但是随后的 Java 6 中并没有增加新的重要的语言特性。Java 5 的发布是在 2004 年，已经很久远了，网上关于 Java 的教程也大多是基于 Java 6 的，也因此我准备从 Java 7 开始介绍每个 Java 版本的新特性。 - -下面所有代码的运行演示都是基于 **Java 7 ** ，所以你如果尝试下面的代码，需要**安装并配置** Jdk 1.7 或者已上版本。 - -# 1. switch String - -在 Java 7 之前，switch 语法中只支持整数类型以及这些整数类型的封装类进行判断，在 Java 7 中，支持了 string 字符串类型的判断，使用起来非常的简单，但是实用性是很高的。 - -## 1.1. switch String 基本用法 - -编写一个简单的 switch 判断字符串的测试类。 - -```java -public class SwitchWithString { - - public static void main(String[] args) { - String gender = "男"; - System.out.println(gender.hashCode()); - switch (gender) { - case "男": - System.out.println("先生你好"); - break; - case "女": - System.out.println("女士你好"); - break; - default: - System.out.println("你好"); - } - } -} -``` - -switch 判断字符串使用起来很简单，结果也显而易见会先输出 gender 变量的 hashCode，然后输出匹配结果“先生你好”。 - -```java -30007 -先生你好 -``` - -在使用 switch string 时候，如果结合 Java 5 的**枚举类**，那么效果会更好，Java 7 之前使用 switch 结合枚举类要为每个枚举值编数字代号，Java 7 之后可以枚举进行 switch。 - -## 1.2. switch String 实现原理 - -但是这个支持**只是编译器层面的支持**， Java 虚拟机依旧是不支持的。在对字符串进行 switch 时，编译器会把字符串**转换成整数**类型再进行判断。为了验证上面说的只是编译器层面的支持，我们反编译（可以使用 Jad 反编译工具，也可以在 Idea 中双击编译生成的 class ）生成的 class 文件，看到编译器把 switch string 转换成了字符串 hashCode 判断，为了防止 hashCode 冲突，又使用了 equals 再次判断。 - -```java -public class SwitchWithString { - public SwitchWithString() { - } - - public static void main(String[] args) { - String gender = "男"; - System.out.println(gender.hashCode()); - byte var3 = -1; - switch(gender.hashCode()) { - case 22899: - if (gender.equals("女")) { - var3 = 1; - } - break; - case 30007: - if (gender.equals("男")) { - var3 = 0; - } - } - - switch(var3) { - case 0: - System.out.println("先生你好"); - break; - case 1: - System.out.println("女士你好"); - break; - default: - System.out.println("你好"); - } - - } -} -``` - -# 2. try-with-resource - -Java 不同于 C++，需要开发者自己管理每一块内存，大多时候 Java 虚拟机都可以很好的帮我们进行资源管理，但是也有时候需要手动释放一些资源，比如数据库连接、磁盘文件连接、网络连接等。换句话说，只要是资源数量有限的，都需要我们手动的进行释放。 - -## 2.1. try-catch-finally - -在操作有限资源的时候，可能会出现各种异常，不管是读取阶段还是在最后关闭资源的过程中，都有可能出现问题，我们通常会使用下面的方式 `try-catch-finally` 保证资源的释放。 - -像下面这样。 - -```java -/** - * 释放资源 - * - * @author www.wdbyte.com - */ -public class TryCatachFinally { - - /** - * 异常处理 - * - * @param args - */ - public static void main(String[] args) throws Exception { - FileInputStream inputStream = null; - try { - inputStream = new FileInputStream("jdk-feature-7.iml"); - } catch (FileNotFoundException e) { - throw e; - } finally { - if (inputStream != null) { - try { - inputStream.close(); - } catch (IOException e) { - throw e; - } - } - } - } -} -``` - -看看这恶心的代码结构，为了捕获异常，我们写了一个 `catch`，为了能保证释放资源，我们又写了 `finally` 进行资源释放，在资源释放时为了捕捉 `close` 时抛出的异常，我们又写了一个 `try-catch`。最后看着这复杂的代码，如果有人告诉你这段代码有 `bug`，那你一定不会相信。但是确实是这样，看起来严密的代码逻辑，当 `try` 中的代码逻辑和 `close` 方法同时产生异常的时候，`try` 中的异常信息会丢失。 - -可以看这里例子。 - -```java -package net.codingme.feature.jdk7; - -import java.io.IOException; - -/** - * 释放资源 - * - * @author www.wdbyte.com - */ -public class TryCatachFinallyThrow { - - /** - * 异常处理 - * - * @param args - */ - public static void main(String[] args) throws Exception { - read(); - } - - public static void read() throws Exception { - FileRead fileRead = null; - try { - fileRead = new FileRead(); - fileRead.read(); - } catch (Exception e) { - throw e; - } finally { - if (fileRead != null) { - try { - fileRead.close(); - } catch (Exception e) { - throw e; - } - } - } - - } -} - -class FileRead { - - public void read() throws Exception { - throw new IOException("读取异常"); - } - - public void close() throws Exception { - System.out.println("资源关闭"); - throw new IOException("关闭异常"); - } -} -``` - -很明显代码里 `read` 和 `close` 方法都会产生异常，但是运行程序发现只能收到 `close` 的异常信息。 - -```log -资源关闭 -Exception in thread "main" java.io.IOException: 关闭异常 - at net.codingme.feature.jdk7.FileRead.close(TryCatachFinallyThrow.java:51) - at net.codingme.feature.jdk7.TryCatachFinallyThrow.read(TryCatachFinallyThrow.java:33) - at net.codingme.feature.jdk7.TryCatachFinallyThrow.main(TryCatachFinallyThrow.java:20) -``` - -**异常信息丢失**了，可怕的是你以为只是 `close` 时发生了异常而已。 - -## 2.2. try-autocloseable - -上面的问题在 Java 7 中其实已经提供了新的解决方式，Java 7 中对 `try` 进行了增强，可以保证资源**总能被正确释放** 。使用增强 `try` 的前提是 `try` 中的类实现了 `AutoCloseable` 接口，在 Java 7 中大量的需要释放资源的操作其实都已经实现了此接口了。 - -![AutoCloseable 实现类](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets/2019/image-20200107084113348.png) - -实现了 `AutoCloseable` 的类，在增强 `try`中使用时，不用担心资源的关闭，在使用完毕会自动的调用 `close`方法，并且**异常不会丢失**。 - -让我们编写的模拟资源操作的类实现 `AutoCloseable` 接口，然后时候增强 `try` 看看效果。 - -```java -package net.codingme.feature.jdk7; - -/** - * 自动关闭 - * - * @author www.wdbyte.com - */ -public class AutoCloseResource { - public static void main(String[] args) throws Exception { - try (Mysql mysql = new Mysql(); - OracleDatabase oracleDatabase = new OracleDatabase()) { - mysql.conn(); - oracleDatabase.conn(); - } - } -} - -class Mysql implements AutoCloseable { - - @Override - public void close() throws Exception { - System.out.println("mysql 已关闭"); - } - - public void conn() { - System.out.println("mysql 已连接"); - } -} - -class OracleDatabase implements AutoCloseable { - - @Override - public void close() throws Exception { - System.out.println("OracleDatabase 已关闭"); - } - - public void conn() { - System.out.println("OracleDatabase 已连接"); - } -} -``` - -测试类 Mysql 和 OracleDatabase 都是实现了 AutoCloseable，运行查看结果。 - -```java -mysql 已连接 -OracleDatabase 已连接 -OracleDatabase 已关闭 -mysql 已关闭 -``` - -确认在发生异常时候异常信息不会丢失，写一个有异常的模拟测试类进行测试。 - -```java -package net.codingme.feature.jdk7; - -import java.io.IOException; - -/** - * 释放资源 - * - * @author www.wdbyte.com - */ -public class AutoCloseThrow { - - public static void main(String[] args) throws Exception { - try (FileReadAutoClose fileRead = new FileReadAutoClose()) { - fileRead.read(); - } - } -} - -class FileReadAutoClose implements AutoCloseable { - - public void read() throws Exception { - System.out.println("资源读取"); - throw new IOException("读取异常"); - } - - @Override - public void close() throws Exception { - System.out.println("资源关闭"); - throw new IOException("关闭异常"); - } -} -``` - -运行查看异常信息。 - -```log -资源读取 -资源关闭 -Exception in thread "main" java.io.IOException: 读取异常 - at net.codingme.feature.jdk7.FileReadAutoClose.read(AutoCloseThrow.java:23) - at net.codingme.feature.jdk7.AutoCloseThrow.main(AutoCloseThrow.java:14) - Suppressed: java.io.IOException: 关闭异常 - at net.codingme.feature.jdk7.FileReadAutoClose.close(AutoCloseThrow.java:29) - at net.codingme.feature.jdk7.AutoCloseThrow.main(AutoCloseThrow.java:15) -``` - -自动关闭，异常清晰，关闭异常存在于 `Suppressed` ，称为抑制异常，后续文章会详细介绍。 - -# 3. try-catch - -在 Java 7 之前，一个 catch 只能捕获一个异常信息，当异常种类非常多的时候就很麻烦，但是在 Java 7 中，一个 catch 可以捕获多个异常信息，每个异常捕获之间使用 `|` 分割， - -```java -package net.codingme.feature.jdk7; - -import java.io.IOException; - -/** - * 多异常捕获 - */ -public class TryCatchMany { - - public static void main(String[] args) { - try (TxtRead txtRead = new TxtRead()) { - txtRead.reader(); - } catch (IOException | NoSuchFieldException e) { - e.printStackTrace(); - } catch (Exception e) { - e.printStackTrace(); - } - } -} - -class TxtRead implements AutoCloseable { - - @Override - public void close() throws Exception { - System.out.println("资源释放"); - } - - public void reader() throws IOException, NoSuchFieldException { - System.out.println("数据读取"); - } -} -``` - -需要注意的是，一个 catch 捕获多个异常时，不能出现重复的异常类型，也不能出现一个异常类型是另一个类的子类的情况。 - -# 4. 二进制 - -Java 7 开始，可以直接指定不同的进制数字。 - -1. 二进制指定数字值，只需要使用 `0b` 或者 `OB` 开头。 -2. 八进制指定数字值，使用 `0` 开头。 -3. 十六进制指定数字值，使用 `0x` 开头。 - -```java -/** - * 二进制 - * - * @author www.wdbyte.com - */ -public class Binary { - public static void main(String[] args) { - // 二进制 - System.out.println("------2进制-----"); - int a = 0b001; - int b = 0b010; - System.out.println(a); - System.out.println(b); - // 八进制 - System.out.println("------8进制-----"); - int a1 = 010; - int b1 = 020; - System.out.println(a1); - System.out.println(b1); - // 十六进制 - System.out.println("------16进制-----"); - int a2 = 0x10; - int b2 = 0x20; - System.out.println(a2); - System.out.println(b2); - } -} -``` - -输出结果。 - -```log -------2进制----- -1 -2 -------8进制----- -8 -16 -------16进制----- -16 -32 -``` - -# 5. 数字下划线 - -Java 7 开始支持在数字定义时候使用下划线分割，增加了数字的可读性。 - -```java -/** - * 数字下环线 - * - * @author www.wdbyte.com - */ -public class NumberLine { - public static void main(String[] args) { - int a = 1_000; - int b = 1_0__0_0_0_____00; - System.out.println(a); - System.out.println(b); - } -} -``` - -得到结果。 - -```log -1000 -1000000 -``` - -# 6. 结束语 - -虽然 Java 7 早在 2011 年就已经发布了，但是据我发现，使用到 Java 7 开始的新特性新语法的并不多，所以我的 JDK 新特性系列文章计划从 Java 7 开始，一直介绍到目前已经发布的 Java 13，以后 Java 新版本更新的同时，这个新特性系列文章也会持续更新。 - -此去山高水远，愿能一路坚持，愿你我一路同行。 - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/jdk/java-08-feature-lambda.md b/docs/jdk/java-08-feature-lambda.md deleted file mode 100644 index 78325c3..0000000 --- a/docs/jdk/java-08-feature-lambda.md +++ /dev/null @@ -1,426 +0,0 @@ ---- -title: 还看不懂同事的代码？Lambda 表达式、函数接口了解一下 -# toc: false -date: 2019-11-11 08:01:01 -url: jdk/jdk8-lambda -tags: - - Java8 - - Lambda -categories: - - Java 新特性 ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -当前时间：2019年 11月 11日，距离 JDK 14 发布时间（2020年3月17日）还有多少天？ - -```java -// 距离JDK 14 发布还有多少天？ -LocalDate jdk14 = LocalDate.of(2020, 3, 17); -LocalDate nowDate = LocalDate.now(); -System.out.println("距离JDK 14 发布还有："+nowDate.until(jdk14,ChronoUnit.DAYS)+"天"); -``` - - - -# 1. 前言 - -`Java 8` 早已经在2014 年 3月 18日发布，毫无疑问 `Java 8` 对 Java 来说绝对算得上是一次重大版本更新，它包含了十多项语言、库、工具、JVM 等方面的十多项新特性。比如提供了语言级的匿名函数，也就是被官方称为 `Lambda` 的表达式语法（外界也称为闭包，` Lambda` 的引入也让流式操作成为可能，减少了代码编写的复杂性），比如函数式接口，方法引用，重复注解。再比如 `Optional` 预防空指针，`Stearm` 流式操作，`LocalDateTime` 时间操作等。 - -在前面的文章里已经介绍了 `Java 8` 的部分新特性。 - -1. [Jdk14 都要出了，Jdk8 的时间处理姿势还不了解一下？](https://www.wdbyte.com/2019/10/jdk/jdk8-time/) - -2. [Jdk14都要出了，还不能使用 Optional优雅的处理空指针？](https://www.wdbyte.com/2019/11/jdk/jdk8-optional/) - -这一次主要介绍一下 Lambda 的相关情况。 - -# 2. Lambda 介绍 - -`Lambda` 名字来源于希腊字母表中排序第十一位的字母 λ，大写为Λ，英语名称为 `Lambda`。在 Java 中 `Lambda` 表达式（lambda expression）是一个匿名函数，在编写 Java 中的 `Lambda` 的时候，你也会发现 `Lambda` 不仅没有函数名称，有时候甚至连入参和返回都可以省略，这也让代码变得更加紧凑。 - -# 3. 函数接口介绍 - -上面说了这次是介绍 `Lambda` 表达式，为什么要介绍函数接口呢？其实 Java 中的函数接口在使用时，可以隐式的转换成 `Lambda` 表达式，在 `Java 8`中已经有很多接口已经声明为函数接口，如 Runnable、Callable、Comparator 等。 - -函数接口的例子可以看下 `Java 8` 中的 `Runnable` 源码（去掉了注释）。 - -```java -package java.lang; - -@FunctionalInterface -public interface Runnable { - public abstract void run(); -} -``` - -那么什么样子的接口才是函数接口呢？有一个很简单的定义，也就是只有`一个抽象函数`的接口，函数接口使用注解 `@FunctionalInterface ` 进行声明（注解声明不是必须的，如果没有注解，也是只有一个抽象函数，依旧会被认为是函数接口）。多一个或者少一个抽象函数都不能定义为函数接口，如果使用了函数接口注解又不止一个抽象函数，那么编译器会拒绝编译。函数接口在使用时候可以隐式的转换成 Lambda 表达式。 - -`Java 8` 中很多有很多不同功能的函数接口定义，都放在了 `Java 8` 新增的 `java.util.function`包内。下面是一些关于 `Java 8` 中函数接口功能的描述。 - -| 序号 | 接口 & 描述 | -| :----------------------- | ------------------------------------------------------------ | -| **BiConsumer** | 代表了一个接受两个输入参数的操作，并且不返回任何结果 | -| **BiFunction** | 代表了一个接受两个输入参数的方法，并且返回一个结果 | -| **BinaryOperator** | 代表了一个作用于于两个同类型操作符的操作，并且返回了操作符同类型的结果 | -| **BiPredicate** | 代表了一个两个参数的boolean值方法 | -| **BooleanSupplier** | 代表了boolean值结果的提供方 | -| **Consumer** | 代表了接受一个输入参数并且无返回的操作 | -| **DoubleBinaryOperator** | 代表了作用于两个double值操作符的操作，并且返回了一个double值的结果。 | -| **DoubleConsumer** | 代表一个接受double值参数的操作，并且不返回结果。 | -| **DoubleFunction** | 代表接受一个double值参数的方法，并且返回结果 | -| **DoublePredicate** | 代表一个拥有double值参数的boolean值方法 | -| **DoubleSupplier** | 代表一个double值结构的提供方 | -| **DoubleToIntFunction** | 接受一个double类型输入，返回一个int类型结果。 | -| **DoubleToLongFunction** | 接受一个double类型输入，返回一个long类型结果 | -| **DoubleUnaryOperator** | 接受一个参数同为类型double,返回值类型也为double 。 | -| **Function** | 接受一个输入参数，返回一个结果。 | -| **IntBinaryOperator** | 接受两个参数同为类型int,返回值类型也为int 。 | -| **IntConsumer** | 接受一个int类型的输入参数，无返回值。 | -| **IntFunction** | 接受一个int类型输入参数，返回一个结果。 | -| **IntPredicate** | 接受一个int输入参数，返回一个布尔值的结果。 | -| **IntSupplier** | 无参数，返回一个int类型结果。 | -| **IntToDoubleFunction** | 接受一个int类型输入，返回一个double类型结果。 | -| **IntToLongFunction** | 接受一个int类型输入，返回一个long类型结果。 | -| **IntUnaryOperator** | 接受一个参数同为类型int,返回值类型也为int 。 | -| **LongBinaryOperator** | 接受两个参数同为类型long,返回值类型也为long。 | -| **LongConsumer** | 接受一个long类型的输入参数，无返回值。 | -| **LongFunction** | 接受一个long类型输入参数，返回一个结果。 | -| **LongPredicate** | 接受一个long输入参数，返回一个布尔值类型结果。 | -| **LongSupplier** | 无参数，返回一个结果long类型的值。 | -| **LongToDoubleFunction** | 接受一个long类型输入，返回一个double类型结果。 | -| **LongToIntFunction** | 接受一个long类型输入，返回一个int类型结果。 | -| **LongUnaryOperator** | 接受一个参数同为类型long,返回值类型也为long。 | -| **ObjDoubleConsumer** | 接受一个object类型和一个double类型的输入参数，无返回值。 | -| **ObjIntConsumer** | 接受一个object类型和一个int类型的输入参数，无返回值。 | -| **ObjLongConsumer** | 接受一个object类型和一个long类型的输入参数，无返回值。 | -| **Predicate** | 接受一个输入参数，返回一个布尔值结果。 | -| **Supplier** | 无参数，返回一个结果。 | -| **ToDoubleBiFunction** | 接受两个输入参数，返回一个double类型结果 | -| **ToDoubleFunction** | 接受一个输入参数，返回一个double类型结果 | -| **ToIntBiFunction** | 接受两个输入参数，返回一个int类型结果。 | -| **ToIntFunction** | 接受一个输入参数，返回一个int类型结果。 | -| **ToLongBiFunction** | 接受两个输入参数，返回一个long类型结果。 | -| **ToLongFunction** | 接受一个输入参数，返回一个long类型结果。 | -| **UnaryOperator** | 接受一个参数为类型T,返回值类型也为T。 | - -（上面表格来源于菜鸟教程） - -# 3. Lambda 语法 - -Lambda 的语法主要是下面几种。 - -1. (params) -> expression - -3. (params) -> {statements;} - -Lambda 的语法特性。 - 1. 使用 `->` 分割 Lambda 参数和处理语句。 - 2. 类型可选，可以不指定参数类型，编译器可以自动判断。 - 3. 圆括号可选，如果只有一个参数，可以不需要圆括号，多个参数必须要圆括号。 - 4. 花括号可选，一个语句可以不用花括号，多个参数则花括号必须。 - 5. 返回值可选，如果只有一个表达式，可以自动返回，不需要 return 语句；花括号中需要 return 语法。 - 6. Lambda 中引用的外部变量必须为 final 类型，内部声明的变量不可修改，内部声明的变量名称不能与外部变量名相同。 - -举几个具体的例子， params 在只有一个参数或者没有参数的时候，可以直接省略不写，像这样。 - -```java -// 1.不需要参数，没有返回值，输出 hello -()->System.out.pritnln("hello"); - -// 2.不需要参数，返回 hello -()->"hello"; - -// 3. 接受2个参数(数字),返回两数之和 -(x, y) -> x + y - -// 4. 接受2个数字参数,返回两数之和 -(int x, int y) -> x + y - -// 5. 两个数字参数，如果都大于10，返回和，如果都小于10，返回差 -(int x,int y) ->{ - if( x > 10 && y > 10){ - return x + y; - } - if( x < 10 && y < 10){ - return Math.abs(x-y); - } -}; -``` - -通过上面的几种情况，已经可以大致了解 Lambda 的语法结构了。 - -# 4. Lambda 使用 - -## 4.1 对于函数接口 - -从上面的介绍中已经知道了 Runnable 接口已经是函数接口了，它可以隐式的转换为 Lambda 表达式进行使用，通过下面的创建线程并运行的例子看下 `Java 8` 中 Lambda 表达式的具体使用方式。 - -```java -/** - * Lambda 的使用，使用 Runnable 例子 - * @throws InterruptedException - */ -@Test -public void createLambda() throws InterruptedException { - // 使用 Lambda 之前 - Runnable runnable = new Runnable() { - @Override - public void run() { - System.out.println("JDK8 之前的线程创建"); - } - }; - new Thread(runnable).start(); - // 使用 Lambda 之后 - Runnable runnable1Jdk8 = () -> System.out.println("JDK8 之后的线程创建"); - new Thread(runnable1Jdk8).start(); - // 更加紧凑的方式 - new Thread(() -> System.out.println("JDK8 之后的线程创建")).start(); -} -``` - -可以发现 `Java 8` 中的 `Lambda` 碰到了函数接口 Runnable，自动推断了要运行的 run 方法，不仅省去了 run 方法的编写，也代码变得更加紧凑。 - -运行得到结果如下。 - -```shell -JDK8 之前的线程创建 -JDK8 之后的线程创建 -JDK8 之后的线程创建 -``` - -上面的 Runnable 函数接口里的 run 方法是没有参数的情况，如果是有参数的，那么怎么使用呢？我们编写一个函数接口，写一个 `say` 方法接受两个参数。 - -```java -/** - * 定义函数接口 - */ -@FunctionalInterface -public interface FunctionInterfaceDemo { - void say(String name, int age); -} -``` - -编写一个测试类。 - -```java - /** - * 函数接口，Lambda 测试 - */ - @Test - public void functionLambdaTest() { - FunctionInterfaceDemo demo = (name, age) -> System.out.println("我叫" + name + "，我今年" + age + "岁了"); - demo.say("金庸", 99); - } -``` - -输出结果。 - -```java -我叫金庸，我今年99岁了。 -``` - -## 4.2 对于方法引用 - -方法引用这个概念前面还没有介绍过，方法引用可以让我们直接访问类的实例或者方法，在 Lambda 只是执行一个方法的时候，就可以不用 `Lambda` 的编写方式，而用方法引用的方式：`实例/类::方法`。这样不仅代码更加的紧凑，而且可以增加代码的可读性。 - -通过一个例子查看方法引用。 - -```java -@Getter -@Setter -@ToString -@AllArgsConstructor -static class User { - private String name; - private Integer age; -} -public static List userList = new ArrayList(); -static { - userList.add(new User("A", 26)); - userList.add(new User("B", 18)); - userList.add(new User("C", 23)); - userList.add(new User("D", 19)); -} -/** - * 测试方法引用 - */ -@Test -public void methodRef() { - User[] userArr = new User[userList.size()]; - userList.toArray(userArr); - // User::getAge 调用 getAge 方法 - Arrays.sort(userArr, Comparator.comparing(User::getAge)); - for (User user : userArr) { - System.out.println(user); - } -} -``` - -得到输出结果。 - -Jdk8Lambda.User(name=B, age=18) -Jdk8Lambda.User(name=D, age=19) -Jdk8Lambda.User(name=C, age=23) -Jdk8Lambda.User(name=A, age=26) - -## 4.3 对于遍历方式 - -Lambda 带来了新的遍历方式，`Java 8` 为集合增加了 `foreach` 方法，它可以接受函数接口进行操作。下面看一下 `Lambda` 的集合遍历方式。 - -```java -/** - * 新的遍历方式 - */ -@Test -public void foreachTest() { - List skills = Arrays.asList("java", "golang", "c++", "c", "python"); - // 使用 Lambda 之前 - for (String skill : skills) { - System.out.print(skill+","); - } - System.out.println(); - // 使用 Lambda 之后 - // 方式1,forEach+lambda - skills.forEach((skill) -> System.out.print(skill+",")); - System.out.println(); - // 方式2，forEach+方法引用 - skills.forEach(System.out::print); -} -``` - -运行得到输出。 - -```shell -java,golang,c++,c,python, -java,golang,c++,c,python, -javagolangc++cpython -``` - -## 4.4 对于流式操作 - -得益于 `Lambda` 的引入，让 `Java 8` 中的流式操作成为可能，`Java 8` 提供了 stream 类用于获取数据流，它专注对数据集合进行各种高效便利操作，提高了编程效率，且同时支持串行和并行的两种模式汇聚计算。能充分的利用多核优势。 - -流式操作如此强大， `Lambda` 在流式操作中怎么使用呢？下面来感受流操作带来的方便与高效。 - -流式操作一切从这里开始。 - -```java -// 为集合创建串行流 -stream() -// 为集合创建并行流 -parallelStream() -``` - -流式操作的去重 `distinct`和过滤 `filter`。 - -```java -@Test -public void streamTest() { - List skills = Arrays.asList("java", "golang", "c++", "c", "python", "java"); - // Jdk8 之前 - for (String skill : skills) { - System.out.print(skill + ","); - } - System.out.println(); - // Jdk8 之后-去重遍历 - skills.stream().distinct().forEach(skill -> System.out.print(skill + ",")); - System.out.println(); - // Jdk8 之后-去重遍历 - skills.stream().distinct().forEach(System.out::print); - System.out.println(); - // Jdk8 之后-去重，过滤掉 ptyhon 再遍历 - skills.stream().distinct().filter(skill -> skill != "python").forEach(skill -> System.out.print(skill + ",")); - System.out.println(); - // Jdk8 之后转字符串 - String skillString = String.join(",", skills); - System.out.println(skillString); -} -``` - -运行得到结果。 - -```shell -java,golang,c++,c,python,java, -java,golang,c++,c,python, -javagolangc++cpython -java,golang,c++,c, -java,golang,c++,c,python,java -``` - -流式操作的数据转换（也称映射）`map`。 - -```java - /** - * 数据转换 - */ - @Test - public void mapTest() { - List numList = Arrays.asList(1, 2, 3, 4, 5); - // 数据转换 - numList.stream().map(num -> num * num).forEach(num -> System.out.print(num + ",")); - - System.out.println(); - - // 数据收集 - Set numSet = numList.stream().map(num -> num * num).collect(Collectors.toSet()); - numSet.forEach(num -> System.out.print(num + ",")); - } -``` - -运行得到结果。 - -```shell -1,4,9,16,25, -16,1,4,9,25, -``` - -流式操作的数学计算。 - -```java -/** - * 数学计算测试 - */ -@Test -public void mapMathTest() { - List list = Arrays.asList(1, 2, 3, 4, 5); - IntSummaryStatistics stats = list.stream().mapToInt(x -> x).summaryStatistics(); - System.out.println("最小值：" + stats.getMin()); - System.out.println("最大值：" + stats.getMax()); - System.out.println("个数：" + stats.getCount()); - System.out.println("和：" + stats.getSum()); - System.out.println("平均数：" + stats.getAverage()); - // 求和的另一种方式 - Integer integer = list.stream().reduce((sum, cost) -> sum + cost).get(); - System.out.println(integer); -} -``` - -运行得到结果。 - -```shell -得到输出 -最小值：1 -最大值：5 -个数：5 -和：15 -平均数：3.0 -15 -``` - -# 5. Lambda 总结 - -`Lamdba` 结合函数接口，方法引用，类型推导以及流式操作，可以让代码变得更加简洁紧凑，也可以借此开发出更加强大且支持并行计算的程序，函数编程也为 Java 带来了新的程序设计方式。但是缺点也很明显，在实际的使用过程中可能会发现调式困难，测试表示 `Lamdba` 的遍历性能并不如 for 的性能高，同事可能没有学习导致看不懂 `Lamdba` 等（可以推荐来看这篇文章）。 - -文章代码已经上传到 [https://github.com/niumoo/jdk-feature)](https://github.com/niumoo/jdk-feature) 。 - - -**最后的话** - ->文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，欢迎Star和指教。更有一线大厂面试点，Java程序员需要掌握的核心知识等文章，也整理了很多我的文字，欢迎 **Star** 和完善，希望我们一起变得优秀。 - -文章有帮助可以点个「**赞**」或「**分享**」，都是支持，我都喜欢！ -文章每周持续更新，要实时关注我更新的文章以及分享的干货，可以关注「 **未读代码** 」公众号或者[我的博客](https://www.wdbyte.com/)。 - -![公众号](https://cdn.jsdelivr.net/gh/niumoo/cdn-assets@439f6a5f6bd130e2aec56f3527656d6edb487b91/webinfo/weixin-public.jpg) \ No newline at end of file diff --git a/docs/jdk/java-08-feature-optional.md b/docs/jdk/java-08-feature-optional.md deleted file mode 100644 index 5f6005f..0000000 --- a/docs/jdk/java-08-feature-optional.md +++ /dev/null @@ -1,357 +0,0 @@ ---- -title: Jdk14都要出了，还不能使用 Optional优雅的处理空指针？ -# toc: false -date: 2019-11-04 08:01:01 -url: jdk/jdk8-optional -tags: - - Java8 - - Optional -categories: - - Java 新特性 ---- - -> 文章已经收录在 [Github.com/niumoo/JavaNotes](https://github.com/niumoo/JavaNotes) ，更有 Java 程序员所需要掌握的核心知识，欢迎Star和指教。 -> 欢迎关注我的[公众号](https://github.com/niumoo/JavaNotes#%E5%85%AC%E4%BC%97%E5%8F%B7)，文章每周更新。 - -# 1. 前言 - -> 如果你没有处理过空指针，那么你不是一位真正的 Java 程序员。 - -空指针确实会产生很多问题，我们经常遇到空的引用，然后又想从这个空的引用上去获取其他的值，接着理所当然的碰到了 `NullPointException`。这是你可能会想，这报错很好处理，然后你看了眼报错行数，对比了下代码。脑海里瞬间闪过 ”对对对，这里有可能为空“，然后加上 `null check`轻松处理。然而你不知道这已经是你处理的第多少个空指针异常了。 - -为了解决上面的问题，在 Java SE8 中引入了一个新类 `java.util.Optional`，这个类可以**缓解**上面的问题。 - -你可能已经发现了，上面我用的是**缓解**而不是**解决**。这也是很多人理解不太对的地方，以为 Java SE8 中的 `Optional` 类可以解决空指针问题。其实 Optional 类的的使用只是**提示**你这里可能存在空值，需要特殊处理，并提供了一些特殊处理的方法。如果你把 `Optional` 类当作空指针的救命稻草而不加思考的使用，那么依旧会碰到错误。 - -因为 `Optional` 是的 Java SE8 中引入的，因此本文中难免会有一些 JDK8 中的语法，如 **Lambda** 表达式，流处理等，但是都是基本形式，不会有过于复杂的案例。 - -# 2. Optional 创建 - -Optional 的创建一共有三种方式。 - -```java -/** - * 创建一个 Optional - */ -@Test -public void createOptionalTest() { - // Optional 构造方式1 - of 传入的值不能为 null - Optional helloOption = Optional.of("hello"); - - // Optional 构造方式2 - empty 一个空 optional - Optional emptyOptional = Optional.empty(); - - // Optional 构造方式3 - ofNullable 支持传入 null 值的 optional - Optional nullOptional = Optional.ofNullable(null); -} -``` - -其中构造方式1中 `of` 方法，如果传入的值会空，会报出 `NullPointerException` 异常。 - -# 3. Optional 判断 - -Optional 只是一个包装对象，想要判断里面有没有值可以使用 `isPresent` 方法检查其中是否有值。 - -```java -/** - * 检查是否有值 - */ -@Test -public void checkOptionalTest() { - Optional helloOptional = Optional.of("Hello"); - System.out.println(helloOptional.isPresent()); - - Optional

限定符和类型	方法和说明
`static java.lang.String`	`getMessage(java.lang.String name, + java.lang.String region)` + 返回一个欢迎信息。 +
`static void`	`main(java.lang.String[] args)` + 启动应用程序 +

Hello web

firest servlet

Hi~

Hi~

Hi~

Java Notes

所有类

所有类

类 JavaDocDemo

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

JavaDocDemo

方法详细资料

main

getMessage

com.wdbyte.comment

类

程序包 com.wdbyte.comment

程序包com.wdbyte.comment的分层结构

类分层结构

常量字段值

目录

已过时的 API

目录

此 API 文档的组织方式

程序包

类/接口

注释类型

枚举

树 (类分层结构)

已过时的 API

索引

上一个/下一个

框架/无框架

所有类

序列化表格

常量字段值

C

G

J

M

所有程序包的分层结构

类分层结构