From c6cf244bb98d7f26d039fdba6de2a7416cb42b42 Mon Sep 17 00:00:00 2001 From: hello-java-maker <1446037005@qq.com> Date: Thu, 15 Sep 2022 01:00:58 +0800 Subject: [PATCH 1/7] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=9C=80=E6=96=B0?= =?UTF-8?q?=E9=9D=A2=E8=AF=95=E8=B5=84=E6=96=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...30\347\233\256\346\200\273\347\273\223.md" | 7725 +++++++++++++---- ...42\350\257\225\351\242\230\344\270\200.md" | 85 +- ...56\344\277\241\345\256\214\346\225\264.md" | 835 ++ ...4\347\220\206-\347\237\245\344\271\216.md" | 1649 ++++ .../test.md" | 4279 +++++++++ ...37\346\234\272\351\235\242\350\257\225.md" | 36 +- ...71\347\233\256\346\200\273\347\273\223.md" | 26 + 7 files changed, 12997 insertions(+), 1638 deletions(-) create mode 100644 "docs/golang/\351\235\242\350\257\225\351\242\230/golang\351\235\242\350\257\225\351\242\230\346\225\264\347\220\206-\345\276\256\344\277\241\345\256\214\346\225\264.md" create mode 100644 "docs/golang/\351\235\242\350\257\225\351\242\230/golang\351\235\242\350\257\225\351\242\230\346\225\264\347\220\206-\347\237\245\344\271\216.md" create mode 100644 "docs/golang/\351\235\242\350\257\225\351\242\230/test.md" create mode 100644 "docs/project/\350\205\276\350\256\257\351\241\271\347\233\256\346\200\273\347\273\223.md" diff --git "a/docs/dataStructures-algorithms/\351\253\230\351\242\221\347\256\227\346\263\225\351\242\230\347\233\256\346\200\273\347\273\223.md" "b/docs/dataStructures-algorithms/\351\253\230\351\242\221\347\256\227\346\263\225\351\242\230\347\233\256\346\200\273\347\273\223.md" index 1d1c4bc..3c616a3 100644 --- "a/docs/dataStructures-algorithms/\351\253\230\351\242\221\347\256\227\346\263\225\351\242\230\347\233\256\346\200\273\347\273\223.md" +++ "b/docs/dataStructures-algorithms/\351\253\230\351\242\221\347\256\227\346\263\225\351\242\230\347\233\256\346\200\273\347\273\223.md" @@ -5,68 +5,445 @@ Ctrl+Shift+P（MacOS：cmd+shift+p）呼出命令面板，输入Markdown Preview -- [翻转链表](#翻转链表) -- [实现二叉树先序，中序和后序遍历](#实现二叉树先序中序和后序遍历) -- [设计LRU缓存结构](#设计lru缓存结构) -- [两个链表的第一个公共结点](#两个链表的第一个公共结点) -- [求平方根](#求平方根) -- [寻找第K大](#寻找第k大) -- [判断链表中是否有环](#判断链表中是否有环) -- [合并有序链表](#合并有序链表) -- [合并k个已排序的链表](#合并k个已排序的链表) -- [数组中相加和为0的三元组](#数组中相加和为0的三元组) -- [删除链表的倒数第n个节点](#删除链表的倒数第n个节点) -- [二分查找](#二分查找) -- [两个链表生成相加链表](#两个链表生成相加链表) -- [二叉树的之字形层序遍历](#二叉树的之字形层序遍历) -- [链表内指定区间反转](#链表内指定区间反转) -- [二叉树的镜像](#二叉树的镜像) -- [数组中只出现一次的数字](#数组中只出现一次的数字) -- [最长的括号子串](#最长的括号子串) -- [把二叉树打印成多行](#把二叉树打印成多行) -- [合并两个有序的数组](#合并两个有序的数组) -- [二叉树的最大路径和](#二叉树的最大路径和) -- [买卖股票的最佳时机](#买卖股票的最佳时机) -- [二叉树中是否存在节点和为指定值的路径](#二叉树中是否存在节点和为指定值的路径) -- [设计getMin功能的栈](#设计getmin功能的栈) -- [LFU缓存结构设计](#lfu缓存结构设计) -- [N皇后问题](#n皇后问题) -- [带权值的最小路径和](#带权值的最小路径和) -- [反转数字](#反转数字) -- [二叉搜索树的第k个结点](#二叉搜索树的第k个结点) -- [子数组最大乘积](#子数组最大乘积) -- [最长递增子序列](#最长递增子序列) -- [在两个长度相等的排序数组中找到上中位数](#在两个长度相等的排序数组中找到上中位数) -- [判断t1树中是否有与t2树拓扑结构完全相同的子树](#判断t1树中是否有与t2树拓扑结构完全相同的子树) -- [反转字符串](#反转字符串) -- [最大正方形](#最大正方形) -- [链表中的节点每K个一组翻转](#链表中的节点每k个一组翻转) -- [数组中的最长无重复子串的长度](#数组中的最长无重复子串的长度) -- [判断链表是否为回文结构](#判断链表是否为回文结构) -- [岛屿的数量](#岛屿的数量) -- [在二叉树中找到两个节点的最近公共祖先](#在二叉树中找到两个节点的最近公共祖先) -- [重复项数字的所有排列](#重复项数字的所有排列) -- [最长回文子串的长度](#最长回文子串的长度) -- [最长公共子序列](#最长公共子序列) -- [最小编辑代价](#最小编辑代价) -- [矩阵的最小路径和](#矩阵的最小路径和) -- [顺时针旋转数组](#顺时针旋转数组) -- [判断一棵树是否是搜索二叉树和完全二叉树](#判断一棵树是否是搜索二叉树和完全二叉树) -- [连续子数组的最大和（sum < 0置为0）](#连续子数组的最大和sum-0置为0httpswwwnowcodercompractice459bd355da1549fa8a49e350bf3df484tpid13tqid11183rp1rutacoding-interviewsqrutacoding-interviewsquestion-ranking) -- [两数之和](#两数之和) -- [删除有序链表中重复出现的元素](#删除有序链表中重复出现的元素) -- [在转动过的有序数组中寻找目标值](#在转动过的有序数组中寻找目标值) -- [数组中未出现的最小正整数](#数组中未出现的最小正整数) -- [数组中最长连续子序列](#数组中最长连续子序列) -- [判断二叉树是否对称](#判断二叉树是否对称) -- [没有重复项数字的所有排列](#没有重复项数字的所有排列) -- [集合的所有子集](#集合的所有子集) +- [Java API整理](#java-api整理) +- [Go API整理](#go-api整理) +- [链表](#链表) + - [排序](#排序) + - [翻转链表, NC78](#翻转链表-nc78) + - [LFU缓存结构设计](#lfu缓存结构设计) + - [设计LRU缓存结构, NC93](#设计lru缓存结构-nc93) + - [合并有序链表, NC33](#合并有序链表-nc33) + - [链表中的节点每K个一组翻转](#链表中的节点每k个一组翻转) + - [判断链表中是否有环](#判断链表中是否有环) + - [链表中环的入口结点](#链表中环的入口结点) + - [删除链表的倒数第n个节点](#删除链表的倒数第n个节点) + - [两个链表的第一个公共结点](#两个链表的第一个公共结点) + - [两个链表生成相加链表](#两个链表生成相加链表) + - [合并k个已排序的链表](#合并k个已排序的链表) + - [单链表的排序，NC70](#单链表的排序nc70) + - [判断链表是否为回文结构](#判断链表是否为回文结构) + - [链表内指定区间反转](#链表内指定区间反转) + - [删除有序链表中重复出现的元素](#删除有序链表中重复出现的元素) + - [环形链表的约瑟夫问题](#环形链表的约瑟夫问题) + - [链表的奇偶重排](#链表的奇偶重排) + - [重排链表（1->n->2->n-1）](#重排链表1-n-2-n-1) + - [二叉搜索树与双向链表](#二叉搜索树与双向链表) +- [队列、栈](#队列栈) + - [用两个栈实现队列](#用两个栈实现队列) + - [有效括号序列](#有效括号序列) + - [包含 min 函数的栈](#包含-min-函数的栈) + - [表达式求值](#表达式求值) + - [最长括号子串](#最长括号子串) + - [括号生成](#括号生成) +- [二叉树](#二叉树) + - [实现二叉树先序，中序和后序遍历](#实现二叉树先序中序和后序遍历) + - [二叉树的层序遍历](#二叉树的层序遍历) + - [二叉树的之字形层序遍历](#二叉树的之字形层序遍历) + - [在二叉树中找到两个节点的最近公共祖先](#在二叉树中找到两个节点的最近公共祖先) + - [重建二叉树](#重建二叉树) + - [输出二叉树的右视图（先重建，再输出右视图）](#输出二叉树的右视图先重建再输出右视图) + - [二叉树的最大深度](#二叉树的最大深度) + - [判断是不是平衡二叉树](#判断是不是平衡二叉树) + - [二叉树根节点到叶子节点的所有路径和](#二叉树根节点到叶子节点的所有路径和) + - [二叉树中和为某一值的路径，返回所有路径](#二叉树中和为某一值的路径返回所有路径) + - [判断一棵二叉树是否为搜索二叉树和完全二叉树](#判断一棵二叉树是否为搜索二叉树和完全二叉树) + - [二叉树的最大路径和](#二叉树的最大路径和) + - [判断二叉树是否对称](#判断二叉树是否对称) + - [二叉树中是否存在节点和为指定值的路径](#二叉树中是否存在节点和为指定值的路径) + - [序列化二叉树](#序列化二叉树) + - [二叉搜索树的第k个结点](#二叉搜索树的第k个结点) + - [把二叉树打印成多行](#把二叉树打印成多行) + - [二叉树的镜像](#二叉树的镜像) + - [判断t1树中是否有与t2树拓扑结构完全相同的子树](#判断t1树中是否有与t2树拓扑结构完全相同的子树) + - [合并二叉树](#合并二叉树) + - [字典树的实现](#字典树的实现) + - [找到二叉搜索树中的两个错误节点](#找到二叉搜索树中的两个错误节点) +- [堆](#堆) + - [最小的K个数](#最小的k个数) + - [字符串出现次数的TopK问题](#字符串出现次数的topk问题) + - [寻找第K大](#寻找第k大) +- [双指针](#双指针) + - [最长无重复子数组的长度](#最长无重复子数组的长度) + - [滑动窗口的最大值](#滑动窗口的最大值) + - [合并区间（区间重叠）](#合并区间区间重叠) + - [反转字符串](#反转字符串) + - [数组中相加和为0的三元组](#数组中相加和为0的三元组) + - [接雨水问题](#接雨水问题) + - [最小覆盖子串（T包含S的最小子串）](#最小覆盖子串t包含s的最小子串) + - [两数之和](#两数之和) + - [最长重复子串（连续两个相同的字符串）](#最长重复子串连续两个相同的字符串) +- [动态规划](#动态规划) + - [跳台阶](#跳台阶) + - [连续子数组的最大和（sum < 0置为0）](#连续子数组的最大和sum--0置为0) + - [最长公共子串（返回具体字符串/长度）](#最长公共子串返回具体字符串长度) + - [斐波那契数列](#斐波那契数列) + - [最长回文子串的长度](#最长回文子串的长度) + - [最长递增子序列](#最长递增子序列) + - [买卖股票的最佳时机](#买卖股票的最佳时机) + - [矩阵的最小路径和](#矩阵的最小路径和) + - [编辑距离](#编辑距离) + - [不同路径的数目](#不同路径的数目) + - [最长公共子序列](#最长公共子序列) + - [最长的括号子串](#最长的括号子串) + - [高空扔鸡蛋](#高空扔鸡蛋) + - [兑换零钱](#兑换零钱) + - [最大正方形](#最大正方形) + - [通配符匹配](#通配符匹配) + - [正则表达式匹配](#正则表达式匹配) + - [矩阵最长递增路径](#矩阵最长递增路径) + - [最长上升子序列](#最长上升子序列) + - [目标和（完全背包）](#目标和完全背包) + - [打家劫舍](#打家劫舍) + - [带权值的最小路径和](#带权值的最小路径和) + - [最长不含重复字符的子字符串](#最长不含重复字符的子字符串) + - [把数字翻译成字符串](#把数字翻译成字符串) +- [二分](#二分) + - [求平方根](#求平方根) + - [在旋转过的有序数组中寻找目标值](#在旋转过的有序数组中寻找目标值) + - [在两个长度相等的排序数组中找到上中位数](#在两个长度相等的排序数组中找到上中位数) + - [有序矩阵元素查找](#有序矩阵元素查找) + - [二分查找](#二分查找) + - [旋转数组的最小数字](#旋转数组的最小数字) + - [数字在升序数组中出现的次数](#数字在升序数组中出现的次数) + - [峰值](#峰值) +- [数组](#数组) + - [数组中只出现一次的数字](#数组中只出现一次的数字) + - [合并两个有序的数组](#合并两个有序的数组) + - [子数组最大乘积](#子数组最大乘积) + - [数组中最长连续子序列](#数组中最长连续子序列) + - [数组中未出现的最小正整数](#数组中未出现的最小正整数) + - [顺时针旋转数组](#顺时针旋转数组) + - [旋转数组](#旋转数组) + - [逆序对](#逆序对) + - [调整数组顺序使奇数位于偶数前面](#调整数组顺序使奇数位于偶数前面) + - [矩阵乘法](#矩阵乘法) +- [回溯](#回溯) + - [字符串的全排列](#字符串的全排列) + - [岛屿的数量](#岛屿的数量) + - [没有重复项数字的所有排列(全排列)](#没有重复项数字的所有排列全排列) + - [集合的所有子集](#集合的所有子集) + - [重复项数字的所有排列](#重复项数字的所有排列) + - [N皇后问题](#n皇后问题) + - [把数组字符串转换为 ip 地址](#把数组字符串转换为-ip-地址) + - [加起来和为目标值的组合](#加起来和为目标值的组合) +- [其他](#其他) + - [螺旋矩阵](#螺旋矩阵) + - [顺时针旋转矩阵](#顺时针旋转矩阵) + - [进制转换](#进制转换) + - [反转数字](#反转数字) + - [大数加法](#大数加法) + - [把字符串转换成整数(atoi)](#把字符串转换成整数atoi) + - [最长公共前缀](#最长公共前缀) + - [回文数字](#回文数字) + - [字符串变形（反序，大写）](#字符串变形反序大写) + - [最大值（数组拼接最大数）](#最大值数组拼接最大数) + - [验证ip地址](#验证ip地址) + - [二进制中1的个数](#二进制中1的个数) + - [第一个只出现一次的字符](#第一个只出现一次的字符) +- [其他编程题（golang、java）](#其他编程题golangjava) + - [单例模式](#单例模式) + - [实现线程安全的生产者消费者](#实现线程安全的生产者消费者) + - [一个10G的文件，里面全部是自然数，一行一个，乱序排列，对其排序。在32位机器上面完成，内存限制为 2G（bitmap原理知道吗？）](#一个10g的文件里面全部是自然数一行一个乱序排列对其排序在32位机器上面完成内存限制为-2gbitmap原理知道吗) + - [实现使用字符串函数名，调用函数](#实现使用字符串函数名调用函数) + - [负载均衡算法。（一致性哈希）](#负载均衡算法一致性哈希) + - [（Goroutine）有三个函数，分别打印"cat", "fish","dog"要求每一个函数都用一个goroutine，按照顺序打印100次](#goroutine有三个函数分别打印cat-fishdog要求每一个函数都用一个goroutine按照顺序打印100次) + - [两个协程交替打印10个字母和数字](#两个协程交替打印10个字母和数字) + - [启动 2个groutine 2秒后取消， 第一个协程1秒执行完，第二个协程3秒执行完。](#启动-2个groutine-2秒后取消-第一个协程1秒执行完第二个协程3秒执行完) + - [当select监控多个chan同时到达就绪态时，如何先执行某个任务？](#当select监控多个chan同时到达就绪态时如何先执行某个任务) +## Java API整理 +- api -### 翻转链表 +https://blog.csdn.net/qq_34756156/article/details/120713595 + +## Go API整理 + +- api + +https://www.pseudoyu.com/zh/2021/05/29/algorithm_data_structure_go/ +https://greyireland.gitbook.io/algorithm-pattern/ru-men-pian/golang + +- 刷题模板 + +https://greyireland.gitbook.io/algorithm-pattern/ + +## 链表 + +### 排序 + +```java +import java.util.*; + + +public class Solution { + + public int[] MySort(int[] arr) { +// 选择排序 +// return selectSort(arr); +// 冒泡排序 +// return bubbleSort(arr); +// 插入排序 +// return insertSort(arr); +// 希尔排序 +// return shellSort(arr); +// 归并排序 +// return mergeSort(arr,0,arr.length-1); +// 快速排序 +// quickSort(arr,0,arr.length-1); +// return arr; +// 计数排序 +// return countSort(arr); +// 基数排序 +// return radixSort(arr); +// 桶排序 + return bucketSort(arr); + } + // 选择排序---选择最小的数与当前数交换 + public int[] selectSort(int[] arr){ + if(arr.length<2)return arr; + for(int i=0;iarr[j])swap(arr,i,j); + } + } + return arr; + } + + // 插入排序---与当前位置之前的所有元素比较，交换元素 + public int[] insertSort(int[] arr){ + if(arr.length<2)return arr; + for(int i=1;i0;j--){ + if(arr[j]0;gap=(gap-1)/3){ + for(int i=gap;i=0;j=j-gap){ + if(arr[j]= right) return ; + int pivot = arr[left]; + int i = left,j = right; + while(i < j){ + while(arr[j] >= pivot && j>i){ + j--; + } + while(arr[i] <= pivot && i0){count++;temp = temp/10;} + if(count>max)max = count; + } + + for(int m=0;m0){temp=temp/10;} + int result = temp%10; + for(int k=0;k0){ + arr[k++] = countArr[i][j]; + } + } + } + return arr; + } + + // 桶排序---给定n个桶，找到最大数与最小数， + // 计算出每个桶能装的数的范围，将数分别放入符合条件的桶中， + // 对每个桶进行快速排序，最后合并 + public int[] bucketSort(int[] arr){ + // 设置桶的个数 + int bucket = 4; + // 找到数组中的最大最小值 + int min = arr[0],max=arr[0]; + for(int i=0;imax)max=arr[i]; + if(arr[i]= min && temp < min+range){ + for(int k =0;k= min+range && temp < min+2*range){ + for(int k =0;k= min+2*range && temp < max - range){ + for(int k =0;k= max - range && temp <= max){ + for(int k =0;k list1 = new ArrayList<>(); - ArrayList list2 = new ArrayList<>(); - ArrayList list3 = new ArrayList<>(); - front(root,list1,list2,list3); - int[][] ints = new int[3][list1.size()]; - for (int i = 0; i < list1.size(); i++) { - ints[0][i] = list1.get(i); - ints[1][i] = list2.get(i); - ints[2][i] = list3.get(i); +class LFUCache { + Map cache; // 存储缓存的内容 + Map> freqMap; // 存储每个频次对应的双向链表 + int size; + int capacity; + int min; // 存储当前最小频次 + + public LFUCache(int capacity) { + cache = new HashMap<> (capacity); + freqMap = new HashMap<>(); + this.capacity = capacity; + } + + public int get(int key) { + Node node = cache.get(key); + if (node == null) { + return -1; } - return ints; + freqInc(node); + return node.value; } - - public void front(TreeNode root,ArrayList list1, - ArrayList list2,ArrayList list3){ - if(root == null){ + + public void put(int key, int value) { + if (capacity == 0) { return; } - - list1.add(root.val); - front(root.left,list1,list2,list3); - list2.add(root.val); - front(root.right,list1,list2,list3); - list3.add(root.val); + Node node = cache.get(key); + if (node != null) { + node.value = value; + freqInc(node); + } else { + if (size == capacity) { + Node deadNode = removeNode(); + cache.remove(deadNode.key); + size--; + } + Node newNode = new Node(key, value); + cache.put(key, newNode); + addNode(newNode); + size++; + } } -} -``` - -- 非递归遍历 - -- 前序遍历 - -用栈来保存信息，但是遍历的时候，是：**先输出根节点信息，然后压入右节点信息，然后再压入左节点信息。** -```java -public void pre(Node head){ - if(head == null){ - return; - } - Stack stack = new Stack<>(); - stack.push(head); - while(!stack.isEmpty()){ - head = stack.poll(); - System.out.println(head.value + " "); - if(head.right != null){ - stack.push(head.right); + void freqInc(Node node) { + // 从原freq对应的链表里移除, 并更新min + int freq = node.freq; + LinkedHashSet set = freqMap.get(freq); + set.remove(node); + if (freq == min && set.size() == 0) { + min = freq + 1; } - if(head.left != null){ - stack.push(head.left); + // 加入新freq对应的链表 + node.freq++; + LinkedHashSet newSet = freqMap.get(freq + 1); + if (newSet == null) { + newSet = new LinkedHashSet<>(); + freqMap.put(freq + 1, newSet); } + newSet.add(node); } - System.out.println(); -} -``` - -- 中序遍历 -中序遍历的顺序是**左中右**，先一直左节点遍历，并压入栈中，当做节点为空时，输出当前节点，往右节点遍历。 - -```java -public void inorder(Node head){ - if(head == null){ - return; + void addNode(Node node) { + LinkedHashSet set = freqMap.get(1); + if (set == null) { + set = new LinkedHashSet<>(); + freqMap.put(1, set); + } + set.add(node); + min = 1; } - Stack stack = new Stack<>(); - stack.push(head); - while(!stack.isEmpty() || head != null){ - if(head != null){ - stack.push(head); - head = head.left - } else { - head = stack.poll(); - System.out.println(head.value + " "); - head = head.right; - } + + Node removeNode() { + LinkedHashSet set = freqMap.get(min); + Node deadNode = set.iterator().next(); + set.remove(deadNode); + return deadNode; } - System.out.println(); } -``` -- 后序遍历 +class Node { + int key; + int value; + int freq = 1; -用两个栈来实现，压入栈1的时候为**先左后右**，栈1弹出来就是**中右左**，栈2收集起来就是**左右中**。 + public Node() {} + + public Node(int key, int value) { + this.key = key; + this.value = value; + } +} +``` +### 设计LRU缓存结构, NC93 -### 设计LRU缓存结构 +- lru-k算法：https://blog.csdn.net/love254443233/article/details/82598381 ```java import java.util.*; - - + public class Solution { /** * lru design @@ -284,119 +652,151 @@ class LRUCache{ } ``` -### 两个链表的第一个公共结点 +```go +type LRUCache struct { + capacity int + m map[int]*Node + head, tail *Node +} -```java -/* -public class ListNode { - int val; - ListNode next = null; - - ListNode(int val) { - this.val = val; +type Node struct { + Key int + Value int + Pre, Next *Node +} + +func (this *LRUCache) Get(key int) int { + if v, ok := this.m[key]; ok { + this.moveToHead(v) + return v.Value } -}*/ -public class Solution { - public ListNode FindFirstCommonNode(ListNode pHead1, - ListNode pHead2) { - if(pHead1 == null || pHead2 == null){ - return null; - } - - ListNode p1 = pHead1; - ListNode p2 = pHead2; - - while(p1 != p2){ - p1 = p1.next; - p2 = p2.next; - if(p1 != p2){ - if(p1 == null) p1 = pHead2; - if(p2 == null) p2 = pHead1; - } - } - - return p1; - + return -1 +} + +func (this *LRUCache) moveToHead(node *Node) { + this.deleteNode(node) + this.addToHead(node) +} + +func (this *LRUCache) deleteNode(node *Node) { + node.Pre.Next = node.Next + node.Next.Pre = node.Pre +} + +func (this *LRUCache) removeTail() int { + node := this.tail.Pre + this.deleteNode(node) + return node.Key +} + +func (this *LRUCache) addToHead(node *Node) { + this.head.Next.Pre = node + node.Next = this.head.Next + node.Pre = this.head + this.head.Next = node +} + +func (this *LRUCache) Put(key int, value int) { + if v, ok := this.m[key]; ok { + v.Value = value + this.moveToHead(v) + return + } + + if this.capacity == len(this.m) { + rmKey := this.removeTail() + delete(this.m, rmKey) + } + + newNode := &Node{Key: key, Value: value} + this.addToHead(newNode) + this.m[key] = newNode +} + +func Constructor(capacity int) LRUCache { + head, tail := &Node{}, &Node{} + head.Next = tail + tail.Pre = head + return LRUCache{ + capacity: capacity, + m: map[int]*Node{}, + head: head, + tail: tail, } } ``` -### 求平方根 +### 合并有序链表, NC33 ```java import java.util.*; +/* + * public class ListNode { + * int val; + * ListNode next = null; + * } + */ public class Solution { /** * - * @param x int整型 - * @return int整型 + * @param l1 ListNode类 + * @param l2 ListNode类 + * @return ListNode类 */ - public int sqrt (int x) { - // write code here - if(x < 2){ - return x; - } - int left = 1; - int right = x / 2; - while(left <= right){ - int mid = left + (right - left) / 2; - if(x / mid == mid){ - return mid; - } else if(x / mid < mid){ - right = mid - 1; - } else if(x / mid > mid){ - left = mid + 1; + public ListNode mergeTwoLists (ListNode l1, ListNode l2) { + ListNode node = new ListNode(0); + ListNode res = node; + while(l1 != null && l2 != null){ + if(l1.val > l2.val){ + node.next = l2; + l2 = l2.next; + } else { + node.next = l1; + l1 = l1.next; } + node = node.next; } - return right; + if(l1 != null){ + node.next = l1; + } + + if(l2 != null){ + node.next = l2; + } + + return res.next; } } ``` -### 寻找第K大 +### 链表中的节点每K个一组翻转 ```java -import java.util.*; - -public class Finder { - public int findKth(int[] a, int n, int K) { - // write code here - return find(a, 0, n-1, K); - } - - public int find(int[] a, int low, int high, int K){ - int pivot = partition(a, low, high); - - if(pivot + 1 < K){ - return find(a, pivot + 1, high, K); - } else if(pivot + 1 > K){ - return find(a, low, pivot - 1, K); - } else { - return a[pivot]; - } - } - - int partition(int arr[], int startIndex, int endIndex){ - int small = startIndex - 1; - for (int i = startIndex; i < endIndex; ++i) { - if(arr[i] > arr[endIndex]) { - swap(arr,++small, i); - } - } - swap(arr,++small,endIndex); - return small; +//明显递归解决，翻转第一组之后，以第二组的开头为头节点，继续翻转，转翻到最后，返回。 +public ListNode reverseKGroup(ListNode head, int k) { + if(head==null||head.next==null) + return head; + ListNode h=new ListNode(0); + h.next=head; + ListNode next=null,tmp=head,cur=head; + for(int i=1;i l2.val){ - node.next = l2; - l2 = l2.next; - } else { - node.next = l1; - l1 = l1.next; - } - node = node.next; + public ListNode removeNthFromEnd (ListNode head, int n) { + // write code here + ListNode dummyNode = new ListNode(0); + dummyNode.next = head; + ListNode fast = dummyNode; + ListNode slow = dummyNode; + for(int i = 0; i <= n; i++){ + fast = fast.next; } - if(l1 != null){ - node.next = l1; + while(fast != null){ + fast = fast.next; + slow = slow.next; } - if(l2 != null){ - node.next = l2; + slow.next = slow.next.next; + + return dummyNode.next; + } +} +``` + +### 两个链表的第一个公共结点 + +```java +/* +public class ListNode { + int val; + ListNode next = null; + + ListNode(int val) { + this.val = val; + } +}*/ +public class Solution { + public ListNode FindFirstCommonNode(ListNode pHead1, ListNode pHead2) { + if(pHead1 == null || pHead2 == null){ + return null; } - return res.next; + ListNode p1 = pHead1; + ListNode p2 = pHead2; + + while(p1 != p2){ + p1 = p1.next; + p2 = p2.next; + if(p1 != p2){ + if(p1 == null) p1 = pHead2; + if(p2 == null) p2 = pHead1; + } + } + + return p1; + } } +``` + +### 两个链表生成相加链表 +```java +import java.util.*; + +/* + * public class ListNode { + * int val; + * ListNode next = null; + * } + */ + +public class Solution { + /** + * + * @param head1 ListNode类 + * @param head2 ListNode类 + * @return ListNode类 + */ + public ListNode addInList (ListNode head1, ListNode head2) { + // write code here + if(head1==null) return head2; + if(head2==null) return head1; + ListNode l1=reverse(head1); + ListNode l2=reverse(head2); + ListNode result=new ListNode(0); + int c=0; + while(l1!=null||l2!=null||c!=0) + { + int v1=l1!=null?l1.val:0; + int v2=l2!=null?l2.val:0; + int val=v1+v2+c; + c=val/10; + ListNode cur=new ListNode(val%10); + cur.next=result.next; + result.next=cur; + if(l1!=null) + l1=l1.next; + if(l2!=null) + l2=l2.next; + } + return result.next; + } + + public ListNode reverse(ListNode node) + { + if(node==null) return node; + ListNode pre=null,next=null; + while(node!=null) + { + next=node.next; + node.next=pre; + pre=node; + node=next; + } + return pre; + } +} ``` ### 合并k个已排序的链表 @@ -540,227 +1061,134 @@ public class Solution { } ``` -### 数组中相加和为0的三元组 +### 单链表的排序，NC70 + +- 堆排序 ```java import java.util.*; - -public class Solution { - public ArrayList> threeSum(int[] num) { - ArrayList> list = new ArrayList<>(); - Arrays.sort(num); - int left,right,sum; - for(int i = 0; i < num.length - 2; i++){ - if(i > 0 && num[i] == num[i-1]) continue; - left = i + 1; - right = num.length - 1; - while(left < right){ - sum = num[i] + num[left] + num[right]; - if(sum == 0){ - ArrayList temp = new ArrayList<>(); - temp.add(num[i]); - temp.add(num[left]); - temp.add(num[right]); - list.add(temp); - right--; - left++; - while(left < right && num[left] == num[left-1]){ - left++; - } - while(left < right && num[right] == num[right+1]){ - right--; - } - } else if(sum < 0){ - left++; - } else { - right--; - } - } - } - return list; - } -} - -``` - -### 删除链表的倒数第n个节点 - -```java -import java.util.*; - -/* - * public class ListNode { - * int val; - * ListNode next = null; - * } - */ - + public class Solution { /** - * - * @param head ListNode类 - * @param n int整型 + * + * @param head ListNode类 the head node * @return ListNode类 */ - public ListNode removeNthFromEnd (ListNode head, int n) { + public ListNode sortInList (ListNode head) { // write code here - ListNode dummyNode = new ListNode(0); - dummyNode.next = head; - ListNode fast = dummyNode; - ListNode slow = dummyNode; - for(int i = 0; i <= n; i++){ - fast = fast.next; + PriorityQueue heap = new PriorityQueue<>((n1, n2) -> n1.val - n2.val); + while (head != null) { + heap.add(head); + head = head.next; } - - while(fast != null){ - fast = fast.next; - slow = slow.next; + ListNode dummy = new ListNode(-1); + ListNode cur = dummy; + while (!heap.isEmpty()) { + cur.next = heap.poll(); + cur = cur.next; } - - slow.next = slow.next.next; - - return dummyNode.next; + cur.next = null; + return dummy.next; } } ``` -### 二分查找 +- 归并排序 ```java import java.util.*; - - public class Solution { - /** - * 二分查找 - * @param n int整型 数组长度 - * @param v int整型 查找值 - * @param a int整型一维数组 有序数组 - * @return int整型 - */ - public int upper_bound_ (int n, int v, int[] a) { - // write code here - int left = 0, right = n; - while(left < right){ - int mid = left + (right - left) / 2; - if(a[mid] == v){ - right = mid; - } else if(a[mid] > v){ - right = mid; - } else { - left = mid + 1; + //合并两段有序链表 + ListNode merge(ListNode pHead1, ListNode pHead2) { + //一个已经为空了，直接返回另一个 + if(pHead1 == null) + return pHead2; + if(pHead2 == null) + return pHead1; + //加一个表头 + ListNode head = new ListNode(0); + ListNode cur = head; + //两个链表都要不为空 + while(pHead1 != null && pHead2 != null){ + //取较小值的节点 + if(pHead1.val <= pHead2.val){ + cur.next = pHead1; + //只移动取值的指针 + pHead1 = pHead1.next; + }else{ + cur.next = pHead2; + //只移动取值的指针 + pHead2 = pHead2.next; } + //指针后移 + cur = cur.next; } - return left+1; - } -} -``` - -### 两个链表生成相加链表 - -```java -import java.util.*; - -/* - * public class ListNode { - * int val; - * ListNode next = null; - * } - */ - -public class Solution { - /** - * - * @param head1 ListNode类 - * @param head2 ListNode类 - * @return ListNode类 - */ - public ListNode addInList (ListNode head1, ListNode head2) { - // write code here - if(head1==null) return head2; - if(head2==null) return head1; - ListNode l1=reverse(head1); - ListNode l2=reverse(head2); - ListNode result=new ListNode(0); - int c=0; - while(l1!=null||l2!=null||c!=0) - { - int v1=l1!=null?l1.val:0; - int v2=l2!=null?l2.val:0; - int val=v1+v2+c; - c=val/10; - ListNode cur=new ListNode(val%10); - cur.next=result.next; - result.next=cur; - if(l1!=null) - l1=l1.next; - if(l2!=null) - l2=l2.next; - } - return result.next; + //哪个链表还有剩，直接连在后面 + if(pHead1 != null) + cur.next = pHead1; + else + cur.next = pHead2; + //返回值去掉表头 + return head.next; } - - public ListNode reverse(ListNode node) - { - if(node==null) return node; - ListNode pre=null,next=null; - while(node!=null) - { - next=node.next; - node.next=pre; - pre=node; - node=next; + + public ListNode sortInList (ListNode head) { + //链表为空或者只有一个元素，直接就是有序的 + if(head == null || head.next == null) + return head; + ListNode left = head; + ListNode mid = head.next; + ListNode right = head.next.next; + //右边的指针到达末尾时，中间的指针指向该段链表的中间 + while(right != null && right.next != null){ + left = left.next; + mid = mid.next; + right = right.next.next; } - return pre; + //左边指针指向左段的左右一个节点，从这里断开 + left.next = null; + //分成两段排序，合并排好序的两段 + return merge(sortInList(head), sortInList(mid)); } } ``` -### 二叉树的之字形层序遍历 +### 判断链表是否为回文结构 ```java import java.util.*; - -/* - * public class TreeNode { - * int val = 0; - * TreeNode left = null; - * TreeNode right = null; - * } - */ - + public class Solution { /** * - * @param root TreeNode类 - * @return int整型ArrayList> + * @param head ListNode类 the head + * @return bool布尔型 */ - public ArrayList> zigzagLevelOrder (TreeNode root) { - // write code here - Queue queue = new LinkedList<>(); - ArrayList> list = new ArrayList<>(); - if(root != null) queue.add(root); - while(!queue.isEmpty()){ - ArrayList temp = new ArrayList<>(); - for(int i = queue.size(); i > 0; i--){ - TreeNode node = queue.poll(); - temp.add(node.val); - if(node.left != null){ - queue.add(node.left); - } - if(node.right != null){ - queue.add(node.right); - } - } - if(list.size() % 2 == 1){ - Collections.reverse(temp); + public boolean isPail (ListNode head) { + ListNode slow = head; + ListNode fast = head; + while(fast != null && fast.next != null){ + fast = fast.next.next; + slow = slow.next; + } + + Stack stack = new Stack<>(); + while(slow != null){ + stack.add(slow.val); + slow = slow.next; + } + + while(!stack.isEmpty()){ + if(stack.pop() != head.val){ + return false; } - list.add(temp); + + head = head.next; } - return list; + + return true; } } - ``` ### 链表内指定区间反转 @@ -808,1591 +1236,5650 @@ public class Solution { return dummy.next; } } - ``` -### 二叉树的镜像 +### 删除有序链表中重复出现的元素 ```java -public class Solution { - public void Mirror(TreeNode root) { - if(root == null){ - return; - } - if(root.left == null && root.right == null){ - return; - } - Stack stack = new Stack<>(); - stack.push(root); - while(!stack.isEmpty()){ - TreeNode node = stack.pop(); - - if(node.left != null || node.right != null){ - TreeNode temp = node.left; - node.left = node.right; - node.right = temp; - } - - if(node.left != null){ - stack.push(node.left); - } - - if(node.right != null){ - stack.push(node.right); +public ListNode deleteDuplicates (ListNode head) { + ListNode dummy=new ListNode(0); + dummy.next=head; + ListNode pre=dummy; + ListNode p=head; + while(p!=null&&p.next!=null){ + if(p.val==p.next.val){ + while(p.next!=null&&p.val==p.next.val){ + p=p.next; } + pre.next=p.next; + p=p.next; + } + else{ + pre=p; + p=p.next; + } + } + return dummy.next; +} +``` + +### 环形链表的约瑟夫问题 + +```java +public int ysf (int n, int m) { + // write code here + ListNode head = new ListNode(1) ,p1=head; + for(int i=2;i<=n;i++){ + ListNode temp = new ListNode(i); + p1.next=temp; + p1=p1.next; + } + p1.next=head; + while(n-->1){ + int num=m; + while(num-->1){ + p1=p1.next; } + p1.next=p1.next.next; } + return p1.val; } - +``` + +### 链表的奇偶重排 + +```java +import java.util.*; + /* + * public class ListNode { + * int val; + * ListNode next = null; + * } + */ + public class Solution { - public void Mirror(TreeNode root) { - if(root == null){ - return; - } - if(root.left == null && root.right == null){ - return; - } - - TreeNode temp = root.left; - root.left = root.right; - root.right = temp; - - if(root.left != null){ - Mirror(root.left); - } - - if(root.right != null){ - Mirror(root.right); - } - } -} -*/ - -``` - -### 数组中只出现一次的数字 - -```java -public class Solution { - - public void FindNumsAppearOnce(int [] array,int num1[] , int num2[]) { - int num = 0; - for(int i = 0; i < array.length; i++){ - num^=array[i]; - } - - int count = 0; - // 标志位，记录num中的第一个1出现的位置 - for(;count < array.length; count++){ - if((num&(1< set = new HashSet<>(); - for(int i = 0; i < array.length; i++){ - if(!set.add(array[i])){ - set.remove(array[i]); - } - } - - Object[] temp = set.toArray(); - num1[0] = (int)temp[0]; - num2[0] = (int)temp[1]; - }*/ } - ``` -### 最长的括号子串 +### 重排链表（1->n->2->n-1） ```java +import java.util.*; public class Solution { - /** - * - * @param s string字符串 - * @return int整型 - */ - public int longestValidParentheses (String s) { - // write code here - if(s == null || s.length() <= 0){ - return 0; - } - - Stack stack = new Stack<>(); - int last = -1; - int maxLen = 0; - for(int i = 0; i < s.length(); i++){ - if(s.charAt(i) == '('){ - stack.push(i); - } else { - if(stack.isEmpty()){ - last = i; - } else { - stack.pop(); - if(stack.isEmpty()){ - maxLen = Math.max(maxLen, i - last); - } else { - maxLen = Math.max(maxLen, i - stack.peek()); - } - } - } + public void reorderList(ListNode head) { + if (head == null || head.next == null) return; + List list = new ArrayList<>(); + ListNode cur = head; + while (cur != null) { + list.add(cur); + cur = cur.next; } - - return maxLen; - } -} - -// 动态规划 -public int longestValidParentheses2(String s) { - if (s == null || s.length() == 0) - return 0; - int[] dp = new int[s.length()]; - int ans = 0; - for (int i = 1; i < s.length(); i++) { - // 如果是'('直接跳过，默认为0 - if (s.charAt(i) == ')') { - if (s.charAt(i - 1) == '(') - dp[i] = (i >= 2 ? dp[i - 2] : 0) + 2; - // 说明s.charAt(i - 1)==')' - else if (i - dp[i - 1] > 0 && - s.charAt(i - dp[i - 1] - 1) == '(') { - dp[i] = (i - dp[i - 1] > 1 ? - dp[i - dp[i - 1] - 2] : 0) + dp[i - 1] + 2; - // 因为加了一个左括号和一个右括号，所以是加2 - } + int l = 0, r = list.size() - 1; + while (l < r) { + list.get(l).next = list.get(r); + l++; + list.get(r).next = list.get(l); + r--; } - ans = Math.max(ans, dp[i]); + list.get(l).next = null; } - return ans; } ``` -### 把二叉树打印成多行 +### 二叉搜索树与双向链表 ```java -import java.util.*; - - -/* +/** public class TreeNode { int val = 0; TreeNode left = null; TreeNode right = null; - + public TreeNode(int val) { this.val = val; - + } - } */ public class Solution { - ArrayList > Print(TreeNode pRoot) { - if(pRoot == null){ - return new ArrayList>(); - } - ArrayList> list = new ArrayList<>(); - - Queue queue = new LinkedList<>(); - queue.add(pRoot); - while(!queue.isEmpty()){ - ArrayList temp = new ArrayList<>(); - for(int i = queue.size(); i > 0; i--){ - TreeNode node = queue.poll(); - temp.add(node.val); - if(node.left != null){ - queue.add(node.left); - } - if(node.right != null){ - queue.add(node.right); - } - } - list.add(temp); + public TreeNode head = null; + public TreeNode dummy = null; + public TreeNode Convert(TreeNode pRootOfTree) { + ConvertSub(pRootOfTree); + return dummy; + } + + public void ConvertSub(TreeNode root){ + if(root == null) return; + ConvertSub(root.left); + + if(head == null){ + head = root; + dummy = root; + } else { + head.right = root; + root.left = head; + head = root; } - - return list; + + ConvertSub(root.right); } - } ``` -### 合并两个有序的数组 +## 队列、栈 + +### 用两个栈实现队列 ```java +import java.util.Stack; public class Solution { - public void merge(int A[], int m, int B[], int n) { - int i = m-1, j = n-1, k = m+n-1; - while(i >= 0 && j >= 0){ - if(A[i] > B[j]){ - A[k--] = A[i--]; - } else { - A[k--] = B[j--]; + Stack stack1 = new Stack(); + Stack stack2 = new Stack(); + + public void push(int node) { + stack1.add(node); + } + + public void pushToPop(){ + if(stack2.isEmpty()){ + while(!stack1.isEmpty()){ + stack2.add(stack1.pop()); } } - - while(j >= 0){ - A[k--] = B[j--]; - } + } + + public int pop() { + pushToPop(); + return stack2.pop(); } } ``` -### 二叉树的最大路径和 +### 有效括号序列 ```java +import java.util.*; public class Solution { - int max = Integer.MIN_VALUE; - /** - * - * @param root TreeNode类 - * @return int整型 - */ - public int maxPathSum (TreeNode root) { + + public boolean isValid (String s) { // write code here - maxSum(root); - return max; - } - - public int maxSum(TreeNode root){ - if(root == null){ - return 0; + Stack stack = new Stack<>(); + char[] chs = s.toCharArray(); + for(int i = 0; i < chs.length; i++){ + if(stack.isEmpty()){ + stack.push(chs[i]); + } else if(chs[i] == '{' || chs[i] == '[' + || chs[i] == '('){ + stack.push(chs[i]); + } else if((chs[i] == '}' && stack.peek() == '{') || + (chs[i] == ']' && stack.peek() == '[') || + (chs[i] == ')' && stack.peek() == '(')){ + stack.pop(); + } } - //三种情况：1.包含一个子树和顶点，2.仅包含顶点，3.包含左子树和右子树以及顶点。 - int left = Math.max(maxSum(root.left),0); - int right = Math.max(maxSum(root.right),0); - - max = Math.max(max,left+right+root.val); - - //对于每一个子树，返回包含该子树顶点的深度方向的路径和的最大值。 - return root.val + Math.max(left,right); + return stack.isEmpty() ? true : false; } } ``` -### 买卖股票的最佳时机 - -base case： -dp[-1][k][0] = dp[i][0][0] = 0 -dp[-1][k][1] = dp[i][0][1] = -infinity - -状态转移⽅程： -dp[i][k][0] = max(dp[i-1][k][0], dp[i-1][k][1] + prices[i]) -dp[i][k][1] = max(dp[i-1][k][1], dp[i-1][k-1][0] - prices[i]) +### 包含 min 函数的栈 ```java +import java.util.Stack; + public class Solution { - /** - * - * @param prices int整型一维数组 - * @return int整型 - */ - public int maxProfit (int[] prices) { - if(prices.length == 0) return 0; - // write code here - int n = prices.length; - int[][] dp = new int[n][2]; - for(int i = 0; i < n; i++){ - if(i - 1 == -1){ - dp[i][0] = 0; - dp[i][1] = -prices[i]; - continue; - } - dp[i][0] = Math.max(dp[i-1][0], - dp[i-1][1] + prices[i]); - dp[i][1] = Math.max(dp[i-1][1],-prices[i]); + Stack minStack = new Stack<>(); + Stack stack = new Stack<>(); + + public void push(int node) { + if(minStack.isEmpty()){ + minStack.push(node); } - return dp[n-1][0]; + if(node < minStack.peek().intValue()){ + minStack.push(node); + } else { + minStack.push(minStack.peek()); + } + + stack.push(node); + } + + public void pop() { + if(stack.isEmpty()){ + return; + } + stack.pop(); + minStack.pop(); + } + + public int top() { + return minStack.peek(); + } + + public int min() { + return minStack.peek(); } } ``` -### 二叉树中是否存在节点和为指定值的路径 +### 表达式求值 + +step 1：使用栈辅助处理优先级，默认符号为加号。 +step 2：遍历字符串，遇到数字，则将连续的数字字符部分转化为int型数字。 +step 3：遇到左括号，则将括号后的部分送入递归，处理子问题； +遇到右括号代表已经到了这个子问题的结尾，结束继续遍历字符串，将子问题的加法部分相加为一个数字，返回。 +step 4：当遇到符号的时候如果是+，得到的数字正常入栈，如果是-，则将其相反数入栈， +如果是*，则将栈中内容弹出与后一个元素相乘再入栈。 +step 5：最后将栈中剩余的所有元素，进行一次全部相加。 + ```java +import java.util.*; public class Solution { - /** - * - * @param root TreeNode类 - * @param sum int整型 - * @return bool布尔型 - */ - public boolean hasPathSum (TreeNode root, int sum) { - // write code here - if(root == null){ - return false; - } - - if(root.left == null && root.right == null){ - return sum - root.val == 0; + public ArrayList function(String s, int index){ + Stack stack = new Stack(); + int num = 0; + char op = '+'; + int i; + for(i = index; i < s.length(); i++){ + //数字转换成int数字 + //判断是否为数字 + if(s.charAt(i) >= '0' && s.charAt(i) <= '9'){ + num = num * 10 + s.charAt(i) - '0'; + if(i != s.length() - 1) + continue; + } + //碰到'('时，把整个括号内的当成一个数字处理 + if(s.charAt(i) == '('){ + //递归处理括号 + ArrayList res = function(s, i + 1); + num = res.get(0); + i = res.get(1); + if(i != s.length() - 1) + continue; + } + switch(op){ + //加减号先入栈 + case '+': + stack.push(num); + break; + case '-': + //相反数 + stack.push(-num); + break; + //优先计算乘号 + case '*': + int temp = stack.pop(); + stack.push(temp * num); + break; + } + num = 0; + //右括号结束递归 + if(s.charAt(i) == ')') + break; + else + op = s.charAt(i); } - - return hasPathSum(root.left,sum - root.val) || - hasPathSum(root.right,sum - root.val); + int sum = 0; + //栈中元素相加 + while(!stack.isEmpty()) + sum += stack.pop(); + ArrayList temp = new ArrayList(); + temp.add(sum); + temp.add(i); + return temp; + } + public int solve (String s) { + ArrayList res = function(s, 0); + return res.get(0); } } ``` -### 设计getMin功能的栈 +### 最长括号子串 + +step 1：可以使用栈来记录左括号下标。 +step 2：遍历字符串，左括号入栈，每次遇到右括号则弹出左括号的下标。 +step 3：然后长度则更新为当前下标与栈顶下标的距离。 +step 4：遇到不符合的括号，可能会使栈为空，因此需要使用start记录上一次结束的位置， +这样用当前下标减去start即可获取长度，即得到子串。 +step 5：循环中最后维护子串长度最大值。 ```java +import java.util.*; public class Solution { - /** - * return a array which include all ans for op3 - * @param op int整型二维数组 operator - * @return int整型一维数组 - */ - public int[] getMinStack (int[][] op) { - // write code here - LinkedList stack = new LinkedList<>(); - LinkedList minStack = new LinkedList<>(); - ArrayList ans = new ArrayList<>(); - - for(int i = 0; i < op.length; i++){ - int type = op[i][0]; - if(type == 1){ - if(minStack.size() == 0){ - minStack.push(op[i][1]); - } else if(op[i][1] <= minStack.peek()){ - minStack.push(op[i][1]); + public int longestValidParentheses(String s) { + if (s == null || s.length() == 0) + return 0; + int[] dp = new int[s.length()]; + int ans = 0; + for (int i = 1; i < s.length(); i++) { + // 如果是'('直接跳过，默认为0 + if (s.charAt(i) == ')') { + if (s.charAt(i - 1) == '(') + dp[i] = (i >= 2 ? dp[i - 2] : 0) + 2; + // 说明s.charAt(i - 1)==')' + else if (i - dp[i - 1] > 0 + && s.charAt(i - dp[i - 1] - 1) == '(') { + dp[i] = (i - dp[i - 1] > 1 + ? dp[i - dp[i - 1] - 2] : 0) + dp[i - 1] + 2; + // 因为加了一个左括号和一个右括号，所以是加2 } - stack.push(op[i][1]); - } else if(type == 2) { - if(stack.peek().equals(minStack.peek())){ - minStack.pop(); - } - stack.pop(); - } else { - ans.add(minStack.peek()); } + ans = Math.max(ans, dp[i]); } - - int[] res = new int[ans.size()]; - for(int i = 0; i < ans.size(); i++){ - res[i] = ans.get(i); - } - return res; + return ans; } } ``` -### LFU缓存结构设计 - ```java -// 解法一 - +import java.util.*; public class Solution { - /** - * lfu design - * @param operators int整型二维数组 ops - * @param k int整型 the k - * @return int整型一维数组 - */ - public int[] LFU (int[][] operators, int k) { - // write code here - if(operators == null) return new int[]{-1}; - HashMap map = new HashMap<>();// key -> value - HashMap count = new HashMap<>(); // key -> count - List list = new ArrayList<>(); - for(int[] ops : operators){ - int type = ops[0]; - int key = ops[1]; - if(type == 1){ - // set操作 - if(map.containsKey(key)){ - map.put(key,ops[2]); - count.put(key,count.get(key)+1); - } else { - if(map.size() == k){ - int minKey = getMinKey(count); - map.remove(minKey); - count.remove(minKey); - } - map.put(key,ops[2]); - if(count.containsKey(key)){ - count.put(key,count.get(key)+1); - } else { - count.put(key,1); - } - } - } else if(type == 2) { - if(map.containsKey(key)){ - int value = map.get(key); - count.put(key,count.get(key)+1); - list.add(value); - } else { - list.add(-1); + public int longestValidParentheses (String s) { + int res = 0; + //记录上一次连续括号结束的位置 + int start = -1; + Stack st = new Stack(); + for(int i = 0; i < s.length(); i++){ + //左括号入栈 + if(s.charAt(i) == '(') + st.push(i); + //右括号 + else{ + //如果右括号时栈为空，不合法，设置为结束位置 + if(st.isEmpty()) + start = i; + else{ + //弹出左括号 + st.pop(); + //栈中还有左括号，说明右括号不够，减去栈顶位置就是长度 + if(!st.empty()) + res = Math.max(res, i - st.peek()); + //栈中没有括号，说明左右括号行号，减去上一次结束的位置就是长度 + else + res = Math.max(res, i - start); } } } - - int[] ans = new int[list.size()]; - for(int i = 0; i < list.size(); i++){ - ans[i] = list.get(i); - } - return ans; - } - - public int getMinKey(HashMap map){ - int minCount = Integer.MAX_VALUE; - int key = 0; - for(Entry entry : map.entrySet()){ - if(entry.getValue() < minCount){ - minCount = entry.getValue(); - key = entry.getKey(); - } - } - return key; + return res; } } +``` -// 解法二 - -import java.util.*; - - -public -class Solution { +### 括号生成 - public class LFUCache { +对于括号的题，核心基本都是: +"一个字符串是合法的括号组合"的*充分必要*条件是: - private class Node { - int k; - int v; - int count; //调用次数 +1. 字符串中开口数等于闭口数 (这是废话) +2. 字符串的所有prefix都满足: 开口数>=闭口数 +举个栗子，比如 "()(())": +prefix: "(", "()", "()(", "()((", "()(()", "()(())". - public Node(int k, int v) { - this.k = k; - this.v = v; - count = 1; - } - } +那么对与这道题，为满足1,2, 每一个位置可以有的permutation就是: - private int size; - private int maxSize; - private Map key2node; - private Map> count2list; //<调用次数，对于调用次数的链表> +1. 如果有多余的开口 -> 可以选开口 +2. 如果有多余未闭合的开口 -> 可以选闭口 - public LFUCache(int maxSize) { - this.maxSize = maxSize; - size = 0; - key2node = new HashMap<>(); - count2list = new HashMap<>(); - } +剩下的就是正常的递归+回溯了 +时间: O(2^n), 每一位最多2个permutation +空间: O(n), 栈高是n - public void set(int k, int v) { - if (key2node.containsKey(k)) { //存在 - key2node.get(k).v = v; - get(k); //get 一次用于改变调用次数 - return; - } - //不存在：建一个新节点 - Node node = new Node(k, v); - //如果调用次数map中不存在，就添加一个新链表 - if (!count2list.containsKey(node.count)) - count2list.put(node.count, new LinkedList<>()); - LinkedList list = count2list.get(node.count); - list.addFirst(node);//插入到该链表的头部，表示该调用次数中，是最近调用的，链表尾才是最久没有调动的 - key2node.put(k, node);//同时加入核心map - size++; - if (size > maxSize) {//超过容量了，删除一个 - key2node.remove(list.getLast().k); - list.removeLast(); - size--; - } - } +```java +import java.util.*; - public int get(int k) { - if (!key2node.containsKey(k)) return -1; - Node node = key2node.get(k);//获取之后 - //还需要更新调用次数： - LinkedList oldList = count2list.get(node.count); - oldList.remove(node);//原来的链表中删除 - if (oldList.isEmpty()) count2list.remove(node.count); - node.count++; - //建立并加入新链表 - if (!count2list.containsKey(node.count)) - count2list.put(node.count, new LinkedList<>()); - LinkedList list = count2list.get(node.count); - list.addFirst(node); - return node.v; - } +public class Solution { + ArrayList ans = new ArrayList<>(); + + public ArrayList generateParenthesis (int n) { + permute(n, n, 0, new StringBuilder()); + return ans; } - - public int[] LFU(int[][] operators, int k) { - LFUCache cache = new LFUCache(k); - List list = new ArrayList<>(); - for (int[] e : operators) { - if (e[0] == 1) cache.set(e[1], e[2]); - else list.add(cache.get(e[1])); - } - int[] res = new int[list.size()]; - for (int i = 0; i < res.length; i++) res[i] = list.get(i); - return res; + + void permute(int open, int close, int unclosedOpen, StringBuilder sb) { + // base case，开口闭口都用完了 + if (open == 0 && close == 0) { + ans.add(sb.toString()); + return; + } + + // always ok to pick an open bracket if there are any open-bracket + if (open > 0) { + sb.append("("); + permute(open-1, close, unclosedOpen+1, sb); + sb.deleteCharAt(sb.length()-1); + } + // can pick close bracket if there is any unclosed open-bracket + if (unclosedOpen > 0) { + sb.append(")"); + permute(open, close-1, unclosedOpen-1, sb); + sb.deleteCharAt(sb.length()-1); + } } } ``` -### N皇后问题 +## 二叉树 + +### 实现二叉树先序，中序和后序遍历 ```java +import java.util.*; + +/* + * public class TreeNode { + * int val = 0; + * TreeNode left = null; + * TreeNode right = null; + * } + */ + public class Solution { /** - * - * @param n int整型 the n - * @return int整型 + * + * @param root TreeNode类 the root of binary tree + * @return int整型二维数组 */ - public int Nqueen (int n) { + public int[][] threeOrders (TreeNode root) { // write code here - List res=new ArrayList<>(); - char[][] chess=new char[n][n]; - for(int i=0;i list1 = new ArrayList<>(); + ArrayList list2 = new ArrayList<>(); + ArrayList list3 = new ArrayList<>(); + front(root,list1,list2,list3); + int[][] ints = new int[3][list1.size()]; + for (int i = 0; i < list1.size(); i++) { + ints[0][i] = list1.get(i); + ints[1][i] = list2.get(i); + ints[2][i] = list3.get(i); } - - backtrack(0,chess,res); - return res.size(); + return ints; } - - // 回溯 - public void backtrack(int row,char[][] chess,List res){ - if(row==chess.length){ - res.add(1); + + public void front(TreeNode root,ArrayList list1, + ArrayList list2,ArrayList list3){ + if(root == null){ return; } - for(int col=0;col=0&&j=0&&i>=0;i--,j--){ - if(chess[i][j]=='Q'){ - return false; - } - } - return true; + + list1.add(root.val); + front(root.left,list1,list2,list3); + list2.add(root.val); + front(root.right,list1,list2,list3); + list3.add(root.val); } } ``` -### 带权值的最小路径和 +- 非递归遍历 + +- 前序遍历 + +用栈来保存信息，但是遍历的时候，是：**先输出根节点信息，然后压入右节点信息，然后再压入左节点信息。** ```java -public class Solution { - /** - * - * @param grid int整型二维数组 - * @return int整型 - */ - public int minPathSum (int[][] grid) { - // write code here - int row = grid.length; - int col = grid[0].length; - int[][] dp = new int[row][col]; - dp[0][0] = grid[0][0]; - for(int i = 1; i < row; i++){ - dp[i][0] = dp[i-1][0] + grid[i][0]; - } - for(int j = 1; j < col; j++){ - dp[0][j] = dp[0][j-1] + grid[0][j]; +public void pre(Node head){ + if(head == null){ + return; + } + Stack stack = new Stack<>(); + stack.push(head); + while(!stack.isEmpty()){ + head = stack.poll(); + System.out.println(head.value + " "); + if(head.right != null){ + stack.push(head.right); } - - for(int i = 1; i < row; i++){ - for(int j = 1; j < col; j++){ - dp[i][j] = Math.min(dp[i][j-1],dp[i-1][j]) + grid[i][j]; - } + if(head.left != null){ + stack.push(head.left); } - - return dp[row-1][col-1]; } + System.out.println(); } ``` -### 反转数字 +- 中序遍历 + +中序遍历的顺序是**左中右**，先一直左节点遍历，并压入栈中，当做节点为空时，输出当前节点，往右节点遍历。 ```java -public class Solution { - /** - * - * @param x int整型 - * @return int整型 - */ - public int reverse (int x) { - // write code here - int res = 0; - while(x != 0){ - // 获取最后一位 - int tail = x % 10; - int newRes = res * 10 + tail; - // 如果不等于，说明溢出 - if((newRes - tail) / 10 != res){ - return 0; - } - res = newRes; - x /= 10; +public void inorder(Node head){ + if(head == null){ + return; + } + Stack stack = new Stack<>(); + stack.push(head); + while(!stack.isEmpty() || head != null){ + if(head != null){ + stack.push(head); + head = head.left + } else { + head = stack.poll(); + System.out.println(head.value + " "); + head = head.right; } - - return res; } + System.out.println(); } ``` -### 二叉搜索树的第k个结点 +- 后序遍历 + +用两个栈来实现，压入栈1的时候为**先左后右**，栈1弹出来就是**中右左**，栈2收集起来就是**左右中**。 ```java -public class Solution { - int index = 0; - TreeNode target = null; - TreeNode KthNode(TreeNode pRoot, int k){ - getKthNode(pRoot,k); - return target; +// 后序遍历-迭代 +public void postIteOrders(TreeNode root, List postList) { + if (root == null) { + return; } - - public void getKthNode(TreeNode pRoot, int k){ - if(pRoot == null){ - return; + // 用两个栈来实现 + // 通过 stack1 和 stack2 来配合可以实现 左 - 右 - 中的顺序 + Stack stack1 = new Stack<>(); + Stack stack2 = new Stack<>(); + stack1.push(root); + while (!stack1.isEmpty()) { + TreeNode node = stack1.pop(); + stack2.push(node); + // 先入左节点 + if (node.left != null) { + stack1.push(node.left); } - getKthNode(pRoot.left,k); - index++; - if(index == k){ - target = pRoot; - return; + // 在入右节点 + if (node.right != null) { + stack1.push(node.right); } - getKthNode(pRoot.right,k); + } + // 弹出元素 + while (!stack2.isEmpty()) { + postList.add(stack2.pop().val); + } +} +``` +### 二叉树的层序遍历 +```java +public ArrayList> levelOrder (TreeNode root) { + // write code here + ArrayList> result = new ArrayList<>(); + if (root == null) { + return result; + } + // 队列，用于存储元素 + Queue queue = new LinkedList<>(); + // 根节点先入队 + queue.offer(root); + // 当队列不为空的时候 + while(!queue.isEmpty()) { + // 队列的大小就是这一层的元素数量 + int size = queue.size(); + ArrayList list = new ArrayList<>(); + // 开始遍历这一层的所有元素 + for (int i = 0; i < size; i ++) { + TreeNode node = queue.poll(); + // 如果左节点不为空，则入队，作为下一层来遍历 + if(node.left != null) { + queue.offer(node.left); + } + // 同上 + if (node.right != null) { + queue.offer(node.right); + } + // 存储一层的节点 + list.add(node.val); + } + // 将一层所有的节点汇入到总的结果集中 + result.add(list); + } + return result; } ``` -### 子数组最大乘积 +### 二叉树的之字形层序遍历 ```java +import java.util.Queue; +import java.util.LinkedList; + public class Solution { - public double maxProduct(double[] arr) { - if(arr.length == 0 || arr == null){ - return 0.0; - } - double[] max = new double[arr.length]; - double[] min = new double[arr.length]; - max[0] = min[0] = arr[0]; - for(int i = 1; i < arr.length; i++){ - max[i] = Math.max(Math.max(max[i-1]*arr[i], - min[i-1]*arr[i]),arr[i]); - min[i] = Math.min(Math.min(max[i-1]*arr[i], - min[i-1]*arr[i]),arr[i]); - } - - double ans = max[0]; - for(int i = 0; i < max.length; i++){ - if(max[i] > ans){ - ans = max[i]; + + public ArrayList> Print(TreeNode root) { + ArrayList> res = new ArrayList<>(); + if (root == null) + return res; + Queue queue = new LinkedList<>(); + queue.add(root); + boolean leftToRight = true; + while (!queue.isEmpty()) { + ArrayList level = new ArrayList<>(); + //统计这一行有多少个节点 + int count = queue.size(); + //遍历这一行的所有节点 + for (int i = 0; i < count; i++) { + //poll移除队列头部元素（队列在头部移除，尾部添加） + TreeNode node = queue.poll(); + //判断是从左往右打印还是从右往左打印。 + if (leftToRight) { + level.add(node.val); + } else { + level.add(0, node.val); + } + //左右子节点如果不为空会被加入到队列中 + if (node.left != null) + queue.add(node.left); + if (node.right != null) + queue.add(node.right); } + res.add(level); + leftToRight = !leftToRight; } - return ans; + return res; } } ``` -### 最长递增子序列 +### 在二叉树中找到两个节点的最近公共祖先 ```java -public int[] LIS (int[] arr) { - // write code here - if(arr == null || arr.length <= 0){ - return null; +import java.util.*; + +public class Solution { + public int lowestCommonAncestor (TreeNode root, int o1, int o2) { + // root为空则说明越过了叶子节点 + if(root == null) return -1; + // 如果root为o1或o2中任意一个，则root就是公共祖先 + if(root.val == o1 || root.val == o2) return root.val; + + //root不为o1或o2 + int left = lowestCommonAncestor(root.left, o1, o2); + int right = lowestCommonAncestor(root.right, o1, o2); + //如果left=-1，说明在左子树中一直找到叶子节点，也没找到最近公共祖先 + //所以最近公共祖先，必在右子树中，right即为最近公共祖先 + if(left == -1) return right; + //同理，最近公共祖先必在左子树中，left即为最近公共祖先 + else if(right == -1) return left; + //若left和right都不为-1，则说明o1,o2节点在root的异侧，则root为最近公共祖先 + else return root.val; } +} +``` - int len = arr.length; - int[] count = new int[len]; // 存长度 - int[] end = new int[len]; // 存最长递增子序列 +### 重建二叉树 - //init - int index = 0; // end 数组下标 - end[index] = arr[0]; - count[0] = 1; +```java - for(int i = 0; i < len; i++){ - if(end[index] < arr[i]){ - end[++index] = arr[i]; - count[i] = index; +import java.util.*; +public class Solution { + public TreeNode reConstructBinaryTree(int [] pre,int [] in) { + if(pre.length == 0||in.length == 0){ + return null; } - else{ - int left = 0, right = index; - while(left <= right){ - int mid = (left + right) >> 1; - if(end[mid] >= arr[i]){ - right = mid - 1; - } - else{ - left = mid + 1; - } + TreeNode node = new TreeNode(pre[0]); + for(int i = 0; i < in.length; i++){ + if(pre[0] == in[i]){ + node.left = reConstructBinaryTree( + Arrays.copyOfRange(pre, 1, i+1), + Arrays.copyOfRange(in, 0, i)); + node.right = reConstructBinaryTree( + Arrays.copyOfRange(pre, i+1, pre.length), + Arrays.copyOfRange(in, i+1,in.length)); } - end[left] = arr[i]; - count[i] = left; } + return node; } +} +``` - //因为返回的数组要求是字典序，所以从后向前遍历 - int[] res = new int[index + 1]; - for(int i = len - 1; i >= 0; i--){ - if(count[i] == index){ - res[index--] = arr[i]; +```java +public TreeNode reConstructBinaryTree(int [] pre, int [] in) { + TreeNode root = rebuild(pre, 0, pre.length - 1, + in, 0, in.length - 1); + return root; +} + +public TreeNode rebuild(int[] preorder, int preStart, + int preEnd, int[] inorder, int inStart, int inEnd) { + if (preStart < 0 || inStart < 0 || + preStart > preEnd || inStart > inEnd) { + return null; + } + TreeNode root = new TreeNode(preorder[preStart]); + + int index = 0; + for (int i = 0; i < inorder.length; i++) { + if (inorder[i] == root.val) { + index = i; + break; } } - return res; + int leftLen = index - inStart; + int rightLen = inEnd - index; + root.left = rebuild(preorder, preStart + 1, + leftLen + preStart, inorder, inStart, index - 1); + root.right = rebuild(preorder, leftLen + preStart + 1, + preEnd, inorder, index + 1, inEnd); + return root; } ``` -### 在两个长度相等的排序数组中找到上中位数 +### 输出二叉树的右视图（先重建，再输出右视图） ```java -public int findMedianinTwoSortedAray (int[] arr1, int[] arr2) { - // write code here - int n = arr1.length; - if(n==0){ - return 0; - } - //arr1左右两端 - int l1=0,r1=n-1; - //arr2左右两端 - int l2=0,r2=n-1; - int mid1,mid2; - //终止条件为l1=r1，即两个数组都只有一个元素，此时的上中位数为两数的最小值 - while(l1< r1){ - //arr1中位数 - mid1 = l1+((r1-l1)>>1); - //arr2中位数 - mid2 = l2+((r2-l2)>>1); - int k = r1-l1+1; - if(arr1[mid1] == arr2[mid2]){ //若两数组中位数相等，整体中位数也是这个 - return arr1[mid1]; +public class Solution { + /** + * 代码中的类名、方法名、参数名已经指定，请勿修改，直接返回方法规定的值即可 + * 求二叉树的右视图 + * @param xianxu int整型一维数组 先序遍历 + * @param zhongxu int整型一维数组 中序遍历 + * @return int整型一维数组 + */ + public int[] solve (int[] preorder, int[] inorder) { + // write code here + if (preorder == null || preorder.length < 1 + || inorder == null || inorder.length < 1) { + return new int[0]; } - else if(arr1[mid1] > arr2[mid2]){ - if(k%2 == 0){//区间元素个数为偶数 - r1 = mid1; //整体中位数在arr1左区间,包括mid1 - l2 = mid2+1; //整体中位数在arr2右区间，不包括mid2 - } - else if(k%2 == 1){ //区间元素个数为奇数 - r1 = mid1; //整体中位数在arr1左区间,包括mid1 - l2 = mid2; //整体中位数在arr2右区间，包括mid2 + TreeNode root = rebuild(preorder, 0, preorder.length - 1, + inorder, 0, inorder.length - 1); + LinkedList queue = new LinkedList<>(); + TreeNode cur = root; + queue.offer(cur); + List list = new ArrayList<>(); + while (!queue.isEmpty()) { + int size = queue.size(); + list.add(queue.peekLast().val); + for (int i = 0; i < size; i++) { + cur = queue.poll(); + if (cur.left != null) { + queue.offer(cur.left); + } + if (cur.right != null) { + queue.offer(cur.right); + } } } - else if (arr1[mid1] < arr2[mid2]){ - if(k%2 == 0){//区间元素个数为偶数 - r2 = mid2; //整体中位数在arr2左区间,包括mid2 - l1 = mid1+1; //整体中位数在arr1右区间，不包括mid1 - } - else if(k%2 == 1){ //区间元素个数为奇数 - r2 = mid2; //整体中位数在arr2左区间,包括mid2 - l1 = mid1; //整体中位数在arr1右区间，包括mid1 + int[] res = new int[list.size()]; + for (int i = 0; i < res.length; i++) { + res[i] = list.get(i); + } + return res; + } + + public TreeNode rebuild(int[] preorder, int preStart, + int preEnd, int[] inorder, int inStart, int inEnd) { + if (preStart < 0 || inStart < 0 || + preStart > preEnd || inStart > inEnd) { + return null; + } + TreeNode root = new TreeNode(preorder[preStart]); + + int index = 0; + for (int i = 0; i < inorder.length; i++) { + if (inorder[i] == root.val) { + index = i; + break; } } + int leftLen = index - inStart; + int rightLen = inEnd - index; + root.left = rebuild(preorder, preStart + 1, + leftLen + preStart, inorder, inStart, index - 1); + root.right = rebuild(preorder, leftLen + preStart + 1, + preEnd, inorder, index + 1, inEnd); + return root; + } + + public static class TreeNode { + public int val; + public TreeNode left; + public TreeNode right; + + public TreeNode(int val) { + this.val = val; + } } - //当区间内只有一个元素时，两个区间中最小值即为整体中位数 - return Math.min(arr1[l1],arr2[l2]); } ``` -### 判断t1树中是否有与t2树拓扑结构完全相同的子树 +### 二叉树的最大深度 ```java -/** - * - * @param root1 TreeNode类 - * @param root2 TreeNode类 - * @return bool布尔型 - */ -public boolean isContains (TreeNode root1, TreeNode root2) { - // write code here - if(root1 == null || root2 == null){ - return false; - } - return recur(root1, root2) || isContains(root1.left,root2) - || isContains(root1.right,root2); +public int maxDepth(TreeNode root) { + return root==null? 0 : + Math.max(maxDepth(root.left), maxDepth(root.right))+1; } +``` -public boolean recur(TreeNode root1, TreeNode root2){ - if(root2 == null){ - return true; +### 判断是不是平衡二叉树 + +```java +import java.util.*; +public class Solution { + public boolean IsBalanced_Solution(TreeNode root) { + //可以分别求出左右子树的高度，然后进行对比 + return TreeDepth(root) >= 0; } - if(root1 == null || root1.val != root2.val){ - return false; + //求二叉树深度的方法 + public int TreeDepth(TreeNode root) { + if (root == null) { + return 0; + } + int leftHeight = TreeDepth(root.left); + int rightHeight = TreeDepth(root.right); + if (leftHeight == -1 || rightHeight == -1 + || Math.abs(leftHeight - rightHeight) > 1) { + return -1; + } else { + return Math.max(leftHeight, rightHeight) + 1; + } } - return recur(root1.left,root2.left) && - recur(root1.right,root2.right); } ``` -### 反转字符串 +### 二叉树根节点到叶子节点的所有路径和 ```java -/** -* 反转字符串 -* @param str string字符串 -* @return string字符串 -*/ -public String solve (String str) { - // write code here - if(str == null){ - return null; +public class Solution { + /** + * + * @param root TreeNode类 + * @return int整型 + */ + public int sumNumbers (TreeNode root) { + // 调用dfs + return dfs(root,0); } - char[] c = new char[str.length()]; - int left = 0, right = str.length() - 1; - - while(left <= right){ - c[left] = str.charAt(right); - c[right] = str.charAt(left); - left++; - right--; + //深度优先搜索 + public int dfs(TreeNode root,int sum){ + if(root==null){ + return 0; + } + int total = sum*10+root.val; + //已达到叶子节点，返回结果 + if(root.left==null && root.right==null){ + return total; + }else{ + //递归调用 + return dfs(root.left,total)+dfs(root.right,total); + } + } - return new String(c); } ``` -### 最大正方形 +### 二叉树中和为某一值的路径，返回所有路径 ```java -/** -* 最大正方形 -* @param matrix char字符型二维数组 -* @return int整型 -*/ -public int solve (char[][] matrix) { - // write code here - int m = matrix.length; - int n = matrix[0].length; - int dp[][] = new int [m][n]; - for(int i = 0; i < m; i++){ - dp[i][0] = matrix[i][0] - '0'; +import java.util.ArrayList; +public class Solution { + ArrayList> lists = new ArrayList<>(); + ArrayList list = new ArrayList<>(); + public ArrayList> FindPath(TreeNode root,int target) { + if(root == null){ + return lists; } - for(int j = 0; j < n; j++){ - dp[0][j] = matrix[0][j] - '0'; - } - int max = 0; - for(int i = 1; i < m; i++){ - for(int j = 1; j < n; j++){ - if(matrix[i][j] == '1'){ - dp[i][j] = Math.min(Math.min(dp[i-1][j-1], - dp[i][j-1]),dp[i-1][j]) + 1; - max = Math.max(max,dp[i][j]); - } + list.add(root.val); + target -= root.val; + if(target == 0 && root.left == null + && root.right == null){ + lists.add(new ArrayList(list)); } + FindPath(root.left,target); + FindPath(root.right,target); + list.remove(list.size() - 1); + return lists; } - return max*max; } ``` -### 链表中的节点每K个一组翻转 +### 判断一棵二叉树是否为搜索二叉树和完全二叉树 ```java -//明显递归解决，翻转第一组之后，以第二组的开头为头节点，继续翻转，转翻到最后，返回。 -public ListNode reverseKGroup(ListNode head, int k) { - if(head==null||head.next==null) - return head; - ListNode h=new ListNode(0); - h.next=head; - ListNode next=null,tmp=head,cur=head; - for(int i=1;i=root.val){ + return false; } - head.next=reverseKGroup(next,k); - return h.next; + num=root.val; + boolean right = isSearch(root.right); + return left && right; } -``` -### 数组中的最长无重复子串的长度 - -```java -public int maxLength (int[] arr) { - int left = 0, right = 0; - Set set = new HashSet<>(); - int res = 1; - while(right < arr.length){ - if(!set.contains(arr[right])){ - set.add(arr[right]); - right++; +public boolean isFull(TreeNode root){ + Queue queue = new LinkedList<>(); + queue.add(root); + while(!queue.isEmpty()){ + TreeNode node = queue.poll(); + if(node==null){ + flag=true; }else{ - set.remove(arr[left]); - left++; + if(flag){ + return false; + }else{ + queue.add(node.left); + queue.add(node.right); + } } - res = Math.max(res, set.size()); } - return res; + return true; } ``` -### 判断链表是否为回文结构 +### 二叉树的最大路径和 ```java -import java.util.*; - public class Solution { + int max = Integer.MIN_VALUE; /** - * - * @param head ListNode类 the head - * @return bool布尔型 + * + * @param root TreeNode类 + * @return int整型 */ - public boolean isPail (ListNode head) { - ListNode slow = head; - ListNode fast = head; - while(fast != null && fast.next != null){ - fast = fast.next.next; - slow = slow.next; + public int maxPathSum (TreeNode root) { + // write code here + maxSum(root); + return max; + } + + public int maxSum(TreeNode root){ + if(root == null){ + return 0; } - Stack stack = new Stack<>(); - while(slow != null){ - stack.add(slow.val); - slow = slow.next; - } + //三种情况：1.包含一个子树和顶点，2.仅包含顶点，3.包含左子树和右子树以及顶点。 + int left = Math.max(maxSum(root.left),0); + int right = Math.max(maxSum(root.right),0); - while(!stack.isEmpty()){ - if(stack.pop() != head.val){ - return false; - } - - head = head.next; - } + max = Math.max(max,left+right+root.val); - return true; + //对于每一个子树，返回包含该子树顶点的深度方向的路径和的最大值。 + return root.val + Math.max(left,right); } } ``` -### 岛屿的数量 +### 判断二叉树是否对称 ```java -class Solution { - public int numIslands(char[][] grid) { - int count = 0; - for(int i = 0; i < grid.length; i++) { - for(int j = 0; j < grid[0].length; j++) { - if(grid[i][j] == '1'){ - bfs(grid, i, j); - count++; - } - } - } - return count; +public class Solution { + /** + * + * @param root TreeNode类 + * @return bool布尔型 + */ + public boolean isSymmetric (TreeNode root) { + // write code here + return isSymmetricNode(root,root); } - public void bfs(char[][] grid, int i, int j){ - Queue list = new LinkedList<>(); - list.add(new int[] { i, j }); - while(!list.isEmpty()){ - int[] cur = list.remove(); - i = cur[0]; j = cur[1]; - if(inArea(i,j,grid) && grid[i][j] == '1') { - grid[i][j] = '0'; - list.add(new int[] { i + 1, j }); - list.add(new int[] { i - 1, j }); - list.add(new int[] { i, j + 1 }); - list.add(new int[] { i, j - 1 }); - } + public boolean isSymmetricNode(TreeNode node1, TreeNode node2){ + if(node1 == null && node2 == null){ + return true; } - } - - public boolean inArea(int i, int j, char[][] grid){ - return i >=0 && j >= 0 && i < grid.length - && j < grid[0].length; + if(node1 == null || node2 == null){ + return false; + } + if(node1.val != node2.val){ + return false; + } + return isSymmetricNode(node1.left,node2.right) + && isSymmetricNode(node1.right,node2.left); } } ``` -### 在二叉树中找到两个节点的最近公共祖先 +### 二叉树中是否存在节点和为指定值的路径 ```java public class Solution { /** * * @param root TreeNode类 - * @param o1 int整型 - * @param o2 int整型 - * @return int整型 + * @param sum int整型 + * @return bool布尔型 */ - public int lowestCommonAncestor (TreeNode root, int o1, int o2) { - if (root == null) { - return 0; - } - if (root.val == o1 || root.val == o2) { - return root.val; - } - int left = lowestCommonAncestor(root.left, o1, o2); - int right = lowestCommonAncestor(root.right, o1, o2); - if (left != 0 && right != 0) { - return root.val; - } - if (left == 0) { - return right; + public boolean hasPathSum (TreeNode root, int sum) { + // write code here + if(root == null){ + return false; } - if (right == 0) { - return left; + + if(root.left == null && root.right == null){ + return sum - root.val == 0; } - return 0; + + return hasPathSum(root.left,sum - root.val) || + hasPathSum(root.right,sum - root.val); } } ``` -### 重复项数字的所有排列 +### 序列化二叉树 ```java -public class Solution { - private ArrayList> res; - private boolean[] visited; - - public ArrayList> permute(int[] nums) { +import java.util.*; +/* +public class TreeNode { + int val = 0; + TreeNode left = null; + TreeNode right = null; - res = new ArrayList<>(); - visited = new boolean[nums.length]; - List list = new ArrayList<>(); - backtrace(nums, list); + public TreeNode(int val) { + this.val = val; - return res; } - private void backtrace(int[] nums, List list) { - - if (list.size() == nums.length) { - res.add(new ArrayList<>(list)); - } - - for (int i = 0; i < nums.length; i++) { - - if (visited[i]) continue; +} +*/ +public class Solution { + private int index = -1; - visited[i] = true; - list.add(nums[i]); + public String Serialize(TreeNode root) { + StringBuilder builder = new StringBuilder(); + intervalSerialize(builder, root); + return builder.toString(); + } - backtrace(nums, list); + private void intervalSerialize(StringBuilder builder, TreeNode root) { + if (root == null) { + builder.append("#,"); + return; + } + builder.append(root.val).append(","); + intervalSerialize(builder, root.left); + intervalSerialize(builder, root.right); + } - visited[i] = false; - list.remove(list.size() - 1); + public TreeNode Deserialize(String str) { + if (str == null || str.isEmpty()) { + return null; + } + String[] words = str.split(","); + return internalDeserialize(words); + } + private TreeNode internalDeserialize(String[] words) { + index++; + if (index == words.length) { + return null; + } + if ("#".equals(words[index])) { + return null; } + TreeNode root = new TreeNode(Integer.parseInt(words[index])); + root.left = internalDeserialize(words); + root.right = internalDeserialize(words); + return root; } } ``` -### 最长回文子串的长度 +### 二叉搜索树的第k个结点 ```java -public class Palindrome { - public int getLongestPalindrome(String A, int n) { - // write code here - int max=0; - for (int i=1;i=0&&right=0&&right > Print(TreeNode pRoot) { + if(pRoot == null){ + return new ArrayList>(); + } + ArrayList> list = new ArrayList<>(); + + Queue queue = new LinkedList<>(); + queue.add(pRoot); + while(!queue.isEmpty()){ + ArrayList temp = new ArrayList<>(); + for(int i = queue.size(); i > 0; i--){ + TreeNode node = queue.poll(); + temp.add(node.val); + if(node.left != null){ + queue.add(node.left); + } + if(node.right != null){ + queue.add(node.right); } } + list.add(temp); } - return res.toString(); + + return list; } + } ``` -### 最小编辑代价 +### 二叉树的镜像 ```java -import java.util.*; - - public class Solution { - /** - * min edit cost - * @param str1 string字符串 the string - * @param str2 string字符串 the string - * @param ic int整型 insert cost - * @param dc int整型 delete cost - * @param rc int整型 replace cost - * @return int整型 - */ - public int minEditCost (String str1, String str2, - int ic, int dc, int rc) { - // write code here - int len1=str1.length(); - int len2=str2.length(); - char[] char1=str1.toCharArray(); - char[] char2=str2.toCharArray(); - int[][] dp=new int[len1+1][len2+1]; - for(int i=1;i<=len1;i++){ - dp[i][0]=dp[i-1][0]+dc; + public void Mirror(TreeNode root) { + if(root == null){ + return; } - for(int i=1;i<=len2;i++){ - dp[0][i]=dp[0][i-1]+ic; + if(root.left == null && root.right == null){ + return; } - for(int i=0;i stack = new Stack<>(); + stack.push(root); + while(!stack.isEmpty()){ + TreeNode node = stack.pop(); + + if(node.left != null || node.right != null){ + TreeNode temp = node.left; + node.left = node.right; + node.right = temp; + } + + if(node.left != null){ + stack.push(node.left); + } + + if(node.right != null){ + stack.push(node.right); } } - return dp[len1][len2]; } } + +/* +public class Solution { + public void Mirror(TreeNode root) { + if(root == null){ + return; + } + if(root.left == null && root.right == null){ + return; + } + + TreeNode temp = root.left; + root.left = root.right; + root.right = temp; + + if(root.left != null){ + Mirror(root.left); + } + + if(root.right != null){ + Mirror(root.right); + } + } +} +*/ + ``` -### 矩阵的最小路径和 +### 判断t1树中是否有与t2树拓扑结构完全相同的子树 ```java -import java.util.*; - +/** + * + * @param root1 TreeNode类 + * @param root2 TreeNode类 + * @return bool布尔型 + */ +public boolean isContains (TreeNode root1, TreeNode root2) { + // write code here + if(root1 == null || root2 == null){ + return false; + } + return recur(root1, root2) || isContains(root1.left,root2) + || isContains(root1.right,root2); +} -public class Solution { - /** - * - * @param matrix int整型二维数组 the matrix - * @return int整型 - */ - public int minPathSum (int[][] matrix) { - // write code here - int m = matrix.length, n = matrix[0].length; - if (m == 0 || n == 0) return 0; - - for (int i = 1; i < m; i++) - matrix[i][0] += matrix[i-1][0]; - for (int i = 1; i < n; i++) - matrix[0][i] += matrix[0][i-1]; - - for (int i = 1; i < m; i++) { - for (int j = 1; j < n; j++) { - matrix[i][j] += - Math.min(matrix[i-1][j], matrix[i][j-1]); - } - } - return matrix[m-1][n-1]; +public boolean recur(TreeNode root1, TreeNode root2){ + if(root2 == null){ + return true; } + if(root1 == null || root1.val != root2.val){ + return false; + } + return recur(root1.left,root2.left) && + recur(root1.right,root2.right); } ``` -### 顺时针旋转数组 +### 合并二叉树 ```java -// 找规律：mat[i][j]被旋转到了mat[j][n-i-1]的位置 -public class Rotate { - public int[][] rotateMatrix(int[][] mat, int n) { - // write code here - int[][] temp=new int[n][n]; - - for(int i=0;i=max){ - return false; + String[] res=new String[len]; + Trie trie=new Trie(); + int id=0; + + for(String[] opera:operators){ + if(opera[0].equals("1")){ + //添加单词 + trie.insert(opera[1]); + } + else if(opera[0].equals("2")){ + //删除单词 + trie.delete(opera[1]); + } + else if(opera[0].equals("3")){ + //查询单词是否存在 + res[id++]=trie.search(opera[1])?"YES":"NO"; + } + else if(opera[0].equals("4")){ + //查找以word为前缀的单词数量 + String preNumber=String.valueOf(trie.prefixNumber(opera[1])); + res[id++]=preNumber; + } } - return isBST(root.left,min,root.val) && isBST(root.right,root.val,max); + return res; } - - - private boolean isComplete(TreeNode root){ - Queue queue = new LinkedList<>(); - queue.offer(root); - - while(!queue.isEmpty()){ - TreeNode tmp = queue.poll(); - if(tmp == null){ - break; + + class Trie{ + //构建字典树节点 + class TrieNode{ + //child数组记录所有子节点 + TrieNode[] child; + //pre_number表示插入单词时，当前节点被访问次数 + int pre_number; + //end表示当前节点是否是某个单词的末尾 + boolean end; + TrieNode(){ + child=new TrieNode[26]; + pre_number=0; + end=false; } - queue.offer(tmp.left); - queue.offer(tmp.right); } - while(!queue.isEmpty()){ - if(queue.poll() != null){ - return false; + + Trie(){} + + //初始化根节点 + TrieNode root=new TrieNode(); + + //添加单词 + void insert(String word){ + TrieNode node=root; + char[] arr=word.toCharArray(); + for(char c:arr){ + //如果子节点不存在，则新建 + if(node.child[c-'a']==null){ + node.child[c-'a']=new TrieNode(); + } + //往子节点方向移动 + node=node.child[c-'a']; + node.pre_number++; } + node.end=true; + } + + void delete(String word){ + TrieNode node=root; + char[] arr=word.toCharArray(); + for(char c:arr){ + //往子节点方向移动，将访问次数减一 + node=node.child[c-'a']; + node.pre_number--; + } + //如果访问次数为0，说明不存在该单词为前缀的单词，以及该单词 + if(node.pre_number==0){ + node.end=false; + } + } + + boolean search(String word){ + TrieNode node=root; + char[] arr=word.toCharArray(); + for(char c:arr){ + //如果子节点不存在，说明不存在该单词 + if(node.child[c-'a']==null){ + return false; + } + node=node.child[c-'a']; + } + + //如果前面的节点都存在，并且该节点末尾标识为true，则存在该单词 + return node.end; + } + + int prefixNumber(String pre){ + TrieNode node=root; + char[] arr=pre.toCharArray(); + for(char c:arr){ + //如果子节点不存在，说明不存在该前缀 + if(node.child[c-'a']==null){ + return 0; + } + node=node.child[c-'a']; + } + + //返回以该单词为前缀的数量 + return node.pre_number; } - return true; } } ``` -### [连续子数组的最大和（sum < 0置为0）](https://www.nowcoder.com/practice/459bd355da1549fa8a49e350bf3df484?tpId=13&&tqId=11183&rp=1&ru=/ta/coding-interviews&qru=/ta/coding-interviews/question-ranking) +### 找到二叉搜索树中的两个错误节点 + +![](http://image.ouyangsihai.cn/FgMj1e8uJv5aZqSy__ZFJ2aN4cCZ) ```java +import java.util.*; +public class Solution { + /** + * + * @param root TreeNode类 the root + * @return int整型一维数组 + */ -// dp -public int FindGreatestSumOfSubArray(int[] array) { - if(array.length == 0){ - return 0; - } - - int max = Integer.MIN_VALUE; - int[] dp = new int[array.length]; - for(int i = 0; i < array.length; i++){ - dp[i] = array[i]; - } - for(int i = 1; i < array.length; i++){ - dp[i] = Math.max(dp[i-1] + array[i],dp[i]); - } - - for(int i = 0; i < dp.length; i++){ - if(dp[i] > max){ - max = dp[i]; + //存储结果集的二维数组 + int[] result = new int[2]; + int index = 1; + TreeNode preNode; + public int[] findError (TreeNode root) { + // 特判 + if(root == null) { + return result; } + // 递归左子树，寻找该树符合条件的节点 + findError(root.left); + if(preNode == null) { + preNode = root; + } + // 判断是否是出错的节点 + if(index == 1 && root.val < preNode.val) { + result[index] = preNode.val; + index--; + } + if(index == 0 && root.val < preNode.val) { + result[index] = root.val; + } + preNode = root; + // 递归右子树，寻找该树符合条件的节点 + findError(root.right); + return result; } - return max; -} - -// sum < 0置为0 -public int FindGreatestSumOfSubArray(int[] array) { - if(array.length == 0){ - return 0; - } - - int max = Integer.MIN_VALUE; - int cur = 0; - for(int i = 0; i < array.length; i++){ - cur += array[i]; - max = Math.max(max,cur); - cur = cur < 0 ? 0 : cur; - } - return max; } - ``` -### 两数之和 +## 堆 + +### 最小的K个数 ```java -import java.util.HashMap; +import java.util.*; public class Solution { - public int[] twoSum(int[] nums, int target) { - HashMap map = new HashMap<>(); - for (int i = 0; i < nums.length; i++) { - if (map.containsKey(nums[i])){ - return new int[]{map.get(nums[i])+1,i+1}; + public ArrayList GetLeastNumbers_Solution(int [] input, int k) { + ArrayList res = new ArrayList(); + //排除特殊情况 + if(k == 0 || input.length == 0) + return res; + //大根堆 + PriorityQueue q = + new PriorityQueue<>((o1, o2)->o2.compareTo(o1)); + //构建一个k个大小的堆 + for(int i = 0; i < k; i++) + q.offer(input[i]); + for(int i = k; i < input.length; i++){ + //较小元素入堆 + if(q.peek() > input[i]){ + q.poll(); + q.offer(input[i]); } - map.put(target - nums[i],i); } - return null; + //堆中元素取出入数组 + for(int i = 0; i < k; i++) + res.add(q.poll()); + return res; } } -``` - -### 删除有序链表中重复出现的元素 - -```java -public ListNode deleteDuplicates (ListNode head) { - ListNode dummy=new ListNode(0); - dummy.next=head; - ListNode pre=dummy; - ListNode p=head; - while(p!=null&&p.next!=null){ - if(p.val==p.next.val){ - while(p.next!=null&&p.val==p.next.val){ - p=p.next; +// 自己实现堆排序 +public class Solution { + public ArrayList + GetLeastNumbers_Solution(int [] input, int k) { + ArrayList list = new ArrayList<>(); + if (input == null || input.length == 0 + || k > input.length || k == 0) + return list; + int[] arr = new int[k + 1];//数组下标0的位置作为哨兵，不存储数据 + //初始化数组 + for (int i = 1; i < k + 1; i++) + arr[i] = input[i - 1]; + buildMaxHeap(arr, k + 1);//构造大根堆 + for (int i = k; i < input.length; i++) { + if (input[i] < arr[1]) { + arr[1] = input[i]; + adjustDown(arr, 1, k + 1);//将改变了根节点的二叉树继续调整为大根堆 } - pre.next=p.next; - p=p.next; - } - else{ - pre=p; - p=p.next; - } + } + for (int i = 1; i < arr.length; i++) { + list.add(arr[i]); + } + return list; + } + /** + * @Author: ZwZ + * @Description: 构造大根堆 + * @Param: [arr, length] length:数组长度 作为是否跳出循环的条件 + * @return: void + * @Date: 2020/1/30-22:06 + */ + public void buildMaxHeap(int[] arr, int length) { + if (arr == null || arr.length == 0 || arr.length == 1) + return; + for (int i = (length - 1) / 2; i > 0; i--) { + adjustDown(arr, i, arr.length); + } + } + /** + * @Author: ZwZ + * @Description: 堆排序中对一个子二叉树进行堆排序 + * @Param: [arr, k, length] + * @return: + * @Date: 2020/1/30-21:55 + */ + public void adjustDown(int[] arr, int k, int length) { + arr[0] = arr[k];//哨兵 + for (int i = 2 * k; i <= length; i *= 2) { + if (i < length - 1 && arr[i] < arr[i + 1]) + i++;//取k较大的子结点的下标 + if (i > length - 1 || arr[0] >= arr[i]) + break; + else { + arr[k] = arr[i]; + k = i; //向下筛选 + } + } + arr[k] = arr[0]; } - return dummy.next; } ``` -### 在转动过的有序数组中寻找目标值 +### 字符串出现次数的TopK问题 ```java -public int search (int[] a, int target) { - // write code here - if(a==null||a.length<=0){ - return -1; - } - int low = 0; - int high = a.length-1; - while(low<=high){ - int mid = low+(high-low)/2; - if(a[mid]==target){ - return mid; - }else if(a[mid] map = new HashMap<>(); + for(int i = 0; i < strings.length; i++){ + if(map.containsKey(strings[i])){ + map.put(strings[i], map.get(strings[i]) + 1); }else{ - high = mid-1; + map.put(strings[i], 1); } - }else{ - if(a[low]<=target&&target> pq = + new PriorityQueue<>((o1,o2) -> o1.getValue().equals(o2.getValue()) + ? o2.getKey().compareTo(o1.getKey()) : o1.getValue()-o2.getValue()); + int size = 0; + //维护size为k的小根堆 + for(Map.Entry m : map.entrySet()){ + if(size < k){ + pq.offer(m); + size++; + } + //大于堆顶元素插入 + else if((m.getValue().equals(pq.peek().getValue()) + ? pq.peek().getKey().compareTo(m.getKey()) + : m.getValue() - pq.peek().getValue()) > 0){ + pq.poll(); + pq.offer(m); } } + //取出堆中元素，从后向前放置 + for(int i = k - 1; i >= 0; i--){ + Map.Entry entry =(Map.Entry)pq.poll(); + res[i][0] = entry.getKey(); + res[i][1] = String.valueOf(entry.getValue()); + } + return res; } - return -1; } ``` -### 数组中未出现的最小正整数 +### 寻找第K大 + +```java +public int findKth(int[] a, int n, int K){ + // 暂存K个较大的值，优先队列默认是自然排序（升序）， + // 队头元素（根）是堆内的最小元素，也就是小根堆 + PriorityQueue queue = new PriorityQueue<>(K); + // 遍历每一个元素，调整小根堆 + for (int num : a) { + // 对于小根堆来说，只要没满就可以加入（不需要比较）； + // 如果满了，才判断是否需要替换第一个元素 + if (queue.size() < K) { + queue.add(num); + } else { + // 在小根堆内，存储着K个较大的元素，根是这K个中最小的， + // 如果出现比根还要大的元素，说明可以替换根 + if (num > queue.peek()) { + queue.poll(); // 高个中挑矮个，矮个淘汰 + queue.add(num); + } + } + } + return queue.isEmpty() ? 0 : queue.peek(); +} +``` ```java -public int minNumberdisappered (int[] arr) { - int n=arr.length; - for(int i=0;i=1&&arr[i]<=n&&arr[arr[i]-1]!=arr[i]){ - swap(arr,arr[i]-1,i); +import java.util.*; + +public class Finder { + public int findKth(int[] a, int n, int K) { + // write code here + return find(a, 0, n-1, K); + } + + public int find(int[] a, int low, int high, int K){ + int pivot = partition(a, low, high); + + if(pivot + 1 < K){ + return find(a, pivot + 1, high, K); + } else if(pivot + 1 > K){ + return find(a, low, pivot - 1, K); + } else { + return a[pivot]; } } - for(int i=0;i arr[endIndex]) { + swap(arr,++small, i); + } } + swap(arr,++small,endIndex); + return small; + } + + public void swap(int[] arr, int i, int j){ + int temp = arr[i]; + arr[i] = arr[j]; + arr[j] = temp; } - return n+1; -} -private void swap(int[] arr,int i,int j){ - int temp=arr[i]; - arr[i]=arr[j]; - arr[j]=temp; } + ``` -### 数组中最长连续子序列 +## 双指针 + +### 最长无重复子数组的长度 ```java -public int MLS (int[] arr) { - if(arr==null || arr.length==0) +// 方法1 +public int maxLength (int[] arr) { + int left = 0, right = 0; + Set set = new HashSet<>(); + int res = 1; + while(right < arr.length){ + if(!set.contains(arr[right])){ + set.add(arr[right]); + right++; + }else{ + set.remove(arr[left]); + left++; + } + res = Math.max(res, set.size()); + } + return res; +} + +// 方法2 +public int maxLength(int[] arr) { + if (arr.length == 0) return 0; - if(arr.length==1) - return 1; - Arrays.sort(arr); - int max = -1; - int count = 1; - for(int i = 0;i map = new HashMap<>(); + int max = 0; + for (int i = 0, j = 0; i < arr.length; ++i) { + if (map.containsKey(arr[i])) { + j = Math.max(j, map.get(arr[i]) + 1); } + map.put(arr[i], i); + max = Math.max(max, i - j + 1); } - max=max maxInWindows(int [] num, int size) + { + ArrayList res = new ArrayList<>(); + if(size == 0) return res; + int begin; + ArrayDeque q = new ArrayDeque<>(); + for(int i = 0; i < num.length; i++){ + begin = i - size + 1; + if(q.isEmpty()) + q.add(i); + else if(begin > q.peekFirst()) + q.pollFirst(); + + while((!q.isEmpty()) && num[q.peekLast()] <= num[i]) + q.pollLast(); + q.add(i); + if(begin >= 0) + res.add(num[q.peekFirst()]); + } + return res; + } +} +``` + +### 合并区间（区间重叠） + +首先将各个区间进行排序，排序规则为首先根据start进行排序， +如果start相等则根据end从小到大排序new一个新的List result存放结果， +遍历给定的intervals，比较当前interval的start是否大于result中最后一个元素的end， +若大于，说明从开了一个区间，若区间有重叠，则更新result中最后一个元素的end。 + +```java +import java.util.*; +/** + * Definition for an interval. + * public class Interval { + * int start; + * int end; + * Interval() { start = 0; end = 0; } + * Interval(int s, int e) { start = s; end = e; } + * } + */ +public class Solution { + public ArrayList merge(ArrayList intervals) { + // 首先根据start排序，如果start相等，根据end排序 + Collections.sort(intervals, + (o1, o2) -> (o1.start != o2.start + ? o1.start - o2.start : o1.end - o2.end)); + ArrayList result = new ArrayList<>(); + if(intervals.size() == 0) { + return result; + } + // 放入第一个区间 + result.add(intervals.get(0)); + int count = 0; + // 遍历后续区间，查看是否与末尾有重叠 + for(int i = 1; i < intervals.size(); i++) { + Interval o1 = intervals.get(i); + Interval origin = result.get(result.size() - 1); + // 如果当前Interval的start比List里面最后一个元素的end大，说明从开一个区间 + if(o1.start > origin.end) { + result.add(o1); + } else { // 区间有重叠，更新结尾 + if(o1.end > origin.end) { + result.get(result.size() - 1).end = o1.end; + } + } + } + return result; + } +} +``` + +### 反转字符串 ```java +import java.util.*; public class Solution { /** - * - * @param root TreeNode类 - * @return bool布尔型 + * 反转字符串 + * @param str string字符串 + * @return string字符串 */ - public boolean isSymmetric (TreeNode root) { + public String solve (String str) { // write code here - return isSymmetricNode(root,root); - } - - public boolean isSymmetricNode(TreeNode node1, TreeNode node2){ - if(node1 == null && node2 == null){ - return true; - } - if(node1 == null || node2 == null){ - return false; + if(str == null){ + return null; } - if(node1.val != node2.val){ - return false; + char[] c = new char[str.length()]; + int left = 0, right = str.length() - 1; + + while(left <= right){ + c[left] = str.charAt(right); + c[right] = str.charAt(left); + left++; + right--; } - return isSymmetricNode(node1.left,node2.right) - && isSymmetricNode(node1.right,node2.left); + return new String(c); } } ``` -### 没有重复项数字的所有排列 +### 数组中相加和为0的三元组 ```java -public class Demo1 { - ArrayList> res; - - public ArrayList> permute(int[] nums) { - res = new ArrayList>(); - if (nums == null || nums.length < 1) - return res; - //对数组元素进行从小到大排序 - Arrays.sort(nums); - ArrayList list = new ArrayList(); +import java.util.*; + +public class Solution { + public ArrayList> threeSum(int[] num) { + ArrayList> list = new ArrayList<>(); + Arrays.sort(num); + int left,right,sum; + for(int i = 0; i < num.length - 2; i++){ + if(i > 0 && num[i] == num[i-1]) continue; + left = i + 1; + right = num.length - 1; + while(left < right){ + sum = num[i] + num[left] + num[right]; + if(sum == 0){ + ArrayList temp = new ArrayList<>(); + temp.add(num[i]); + temp.add(num[left]); + temp.add(num[right]); + list.add(temp); + right--; + left++; + while(left < right && num[left] == num[left-1]){ + left++; + } + while(left < right && num[right] == num[right+1]){ + right--; + } + } else if(sum < 0){ + left++; + } else { + right--; + } + } + } + return list; + } +} +``` - solve(list, nums); +### 接雨水问题 - return res; - } +```java + public long maxWater(int[] arr) { + if (arr.length <= 2) + return 0; + //找到最高的柱子的下标 + int max = Integer.MIN_VALUE; + int maxIndex = -1; + for (int i = 0; i < arr.length; i++) { + if (arr[i] > max) { + max = arr[i]; + maxIndex = i; + } + } + + //统计最高柱子左边能接的雨水数量 + int left = arr[0]; + int right = 0; + long water = 0; + for (int i = 1; i < maxIndex; i++) { + right = arr[i]; + if (right > left) { + left = right; + } else { + water += left - right; + } + } + + //统计最高柱子右边能接的雨水数量 + right = arr[arr.length - 1]; + for (int i = arr.length - 2; i > maxIndex; i--) { + left = arr[i]; + if (arr[i] > right) { + right = left; + } else { + water += right - left; + } + } + + //返回盛水量 + return water; + } +``` - private void solve(ArrayList list, int[] nums) { - if (list.size() == nums.length) { - res.add(new ArrayList(list)); - return; - } - for (int i = 0; i < nums.length; i++) { - if (!list.contains(nums[i])) { - list.add(nums[i]); - solve(list, nums); - list.remove(list.size() - 1); - } - } - } +```java +public long maxWater (int[] arr) { + int l = 0, r = arr.length-1; + int maxL = 0, maxR = 0; + long res = 0; + while(l < r){ + maxL = Math.max(arr[l],maxL); // 求出左边界的最大值 + maxR = Math.max(arr[r],maxR); // 求出右边界的最大值 + if(maxR > maxL){ // 如果 + res += maxL - arr[l++]; + }else{ + res += maxR - arr[r--]; + } + } + return res; } ``` -### 集合的所有子集 +### 最小覆盖子串（T包含S的最小子串） ```java import java.util.*; + public class Solution { - public ArrayList> subsets(int[] S) { - ArrayList> res=new ArrayList<>(); - Arrays.sort(S); - LinkedList list=new LinkedList<>(); - dfs(res,list,0,S); - return res; - } - public void dfs(ArrayList> res, - LinkedList list, int k, int[] S){ - res.add(new ArrayList<>(list)); - for(int i=k;i window = new HashMap<>(); + HashMap need = new HashMap<>(); + for (int i = 0; i < t.length(); i++) { + Integer count = need.get(t.charAt(i)); + count = count == null ? 1 : ++count; + need.put(t.charAt(i),count); } + int left =0 , right = 0; + int vaild = 0; + int len = Integer.MAX_VALUE,start = 0; + //最小覆盖字串起始索引 + while (right < s.length()){ + char c = s.charAt(right); + right++; + if (need.containsKey(c)){ + Integer count = window.get(c); + count = count == null ? 1 : ++count; + window.put(c,count); + if (window.get(c).equals(need.get(c))){ + vaild++; + } + } + + //都包含了，right找到了，可以考虑收缩 + while (vaild == need.size()){ + if (right -left < len){ + start = left; + len = right - left; + } + //d是将要移出窗口的字符 + char d = s.charAt(left); + //左移窗口 + left++; + //数据更新 + if (need.containsKey(d)){ + if (window.get(d).equals(need.get(d))){ + vaild--; + } + window.put(d,window.get(d)-1); + } + } + } + return len == Integer.MAX_VALUE + ? "" : s.substring(start,start+len); } } +``` + +### 两数之和 + +```java +import java.util.HashMap; +public class Solution { + public int[] twoSum(int[] nums, int target) { + HashMap map = new HashMap<>(); + for (int i = 0; i < nums.length; i++) { + if (map.containsKey(nums[i])){ + return new int[]{map.get(nums[i])+1,i+1}; + } + map.put(target - nums[i],i); + } + return null; + } +} +``` + +### 最长重复子串（连续两个相同的字符串） + +```java +import java.util.*; +public class Solution { + // 使用滑动窗口 滑动窗口中的字符串是重复字符串的一半 + public int solve (String a) { + //枚举长度为i的窗口(按窗口大小倒序枚举)，找到第一个满足条件的窗口(窗口为重复子串) + char[] cs = a.toCharArray(); + int len = cs.length; + int cnt = 0; + // 滑动窗口的大小不可能大于数组长度的一半 + for (int i=len/2; i>0; i--) { //枚举一半窗口大小 + //窗口右侧节点范围len-i + for (int j=0; j max){ + max = dp[i]; + } + } + return max; +} + +// sum < 0置为0 +public int FindGreatestSumOfSubArray(int[] array) { + if(array.length == 0){ + return 0; + } + + int max = Integer.MIN_VALUE; + int cur = 0; + for(int i = 0; i < array.length; i++){ + cur += array[i]; + max = Math.max(max,cur); + cur = cur < 0 ? 0 : cur; + } + return max; +} +``` + +### 最长公共子串（返回具体字符串/长度） + +```java +// 返回字符串 +public class Solution { + public String LCS (String str1, String str2) { + // write code here + int m = str1.length(); + int n = str2.length(); + int[][] dp = new int[m][n]; + int maxLength = 0; + int lastIndex = 0; + //用来记录str1中最长公共串的最后一个字符的下标 + for(int i = 0; i < m; i++){ + for(int j = 0; j < n; j++){ + if(str1.charAt(i) == str2.charAt(j)){ + //判断str1中第i个字符是否和str2中第j个字符相等 + if(i == 0 || j == 0){ + dp[i][j] = 1; + }else{ + dp[i][j] = dp[i - 1][j - 1] + 1; + } + + if(dp[i][j] > maxLength){ + //判断是否需要更新最长公共子串 + maxLength = dp[i][j]; + lastIndex = i; + } + } + } + } + + //通过str1来截取长度为maxLength, 最后字符坐标为lastIndex的子串 + return str1.substring(lastIndex - maxLength + 1, + lastIndex + 1); + } +} + +// 返回长度 +public class Solution { + public int LCS (String s1, String s2) { + // write code here + int mLength = s1.length(); + int nLength = s2.length(); + int[][] dp = new int[mLength + 1][nLength + 1]; + char[] c1 = s1.toCharArray(); + char[] c2 = s2.toCharArray(); + for (int i = 0; i <= mLength; i++) { + dp[i][0] = 0; + } + for (int j = 0; j <= nLength; j++) { + dp[0][j] = 0; + } + for (int i = 1; i <= mLength; i++) { + for (int j = 1; j <= nLength; j++) { + if (c1[i - 1] != c2[j - 1]) { + dp[i][j] = + Math.max(dp[i- 1][j], dp[i][j - 1]); + } else { + dp[i][j] = dp[i - 1][j - 1] + 1; + } + } + } + return dp[mLength][nLength]; + } +} +``` + +### 斐波那契数列 + +```java +public class Solution { + public int Fibonacci(int n) { + if(n == 0){ + return 0; + } + if(n == 1 || n == 2){ + return 1; + } + return Fibonacci(n-1) + Fibonacci(n-2); + } +} +``` + +### 最长回文子串的长度 + +```java +public String longestPalindrome1(String s) { + if (s == null || s.length() == 0) { + return ""; + } + int strLen = s.length(); + int left = 0; + int right = 0; + int len = 1; + int maxStart = 0; + int maxLen = 0; + + for (int i = 0; i < strLen; i++) { + left = i - 1; + right = i + 1; + while (left >= 0 && + s.charAt(left) == s.charAt(i)) { + len++; + left--; + } + while (right < strLen && + s.charAt(right) == s.charAt(i)) { + len++; + right++; + } + while (left >= 0 && right < strLen + && s.charAt(right) == s.charAt(left)) { + len = len + 2; + left--; + right++; + } + if (len > maxLen) { + maxLen = len; + maxStart = left; + } + len = 1; + } + return s.substring(maxStart + 1, + maxStart + maxLen + 1); + +} +``` + +### 最长递增子序列 + +```java +// 求长度 +class Solution { + public int lengthOfLIS(int[] nums) { + if(nums.length == 0) return 0; + int[] dp = new int[nums.length]; + int res = 0; + Arrays.fill(dp, 1); + for(int i = 0; i < nums.length; i++) { + for(int j = 0; j < i; j++) { + if(nums[j] < nums[i]) + dp[i] = Math.max(dp[i], dp[j] + 1); + } + res = Math.max(res, dp[i]); + } + return res; + } +} +``` + +```java +public int[] LIS (int[] arr) { + // write code here + if(arr == null || arr.length <= 0){ + return null; + } + + int len = arr.length; + int[] count = new int[len]; // 存长度 + int[] end = new int[len]; // 存最长递增子序列 + + //init + int index = 0; // end 数组下标 + end[index] = arr[0]; + count[0] = 1; + + for(int i = 0; i < len; i++){ + if(end[index] < arr[i]){ + end[++index] = arr[i]; + count[i] = index; + } + else{ + int left = 0, right = index; + while(left <= right){ + int mid = (left + right) >> 1; + if(end[mid] >= arr[i]){ + right = mid - 1; + } + else{ + left = mid + 1; + } + } + end[left] = arr[i]; + count[i] = left; + } + } + + //因为返回的数组要求是字典序，所以从后向前遍历 + int[] res = new int[index + 1]; + for(int i = len - 1; i >= 0; i--){ + if(count[i] == index){ + res[index--] = arr[i]; + } + } + return res; +} +``` + +### 买卖股票的最佳时机 + +base case： +dp[-1][k][0] = dp[i][0][0] = 0 +dp[-1][k][1] = dp[i][0][1] = -infinity + +状态转移⽅程： +dp[i][k][0] = max(dp[i-1][k][0], dp[i-1][k][1] + prices[i]) +dp[i][k][1] = max(dp[i-1][k][1], dp[i-1][k-1][0] - prices[i]) + +- k == 1 + +```java +public class Solution { + /** + * + * @param prices int整型一维数组 + * @return int整型 + */ + public int maxProfit (int[] prices) { + if(prices.length == 0) return 0; + // write code here + int n = prices.length; + int[][] dp = new int[n][2]; + for(int i = 0; i < n; i++){ + if(i - 1 == -1){ + dp[i][0] = 0; + dp[i][1] = -prices[i]; + continue; + } + dp[i][0] = Math.max(dp[i-1][0], + dp[i-1][1] + prices[i]); + dp[i][1] = Math.max(dp[i-1][1],-prices[i]); + } + + return dp[n-1][0]; + } +} + +// 空间复杂度优化版本 +int maxProfit(int[] prices) { + int n = prices.length; + // base case: dp[-1][0] = 0, dp[-1][1] = -infinity + int dp_i_0 = 0, dp_i_1 = Integer.MIN_VALUE; + for (int i = 0; i < n; i++) { + // dp[i][0] = max(dp[i-1][0], dp[i-1][1] + prices[i]) + dp_i_0 = Math.max(dp_i_0, dp_i_1 + prices[i]); + // dp[i][1] = max(dp[i-1][1], -prices[i]) + dp_i_1 = Math.max(dp_i_1, -prices[i]); + } + return dp_i_0; +} +``` + +- k 为正无穷 + +```java +// 原始版本 +int maxProfit_k_inf(int[] prices) { + int n = prices.length; + int[][] dp = new int[n][2]; + for (int i = 0; i < n; i++) { + if (i - 1 == -1) { + // base case + dp[i][0] = 0; + dp[i][1] = -prices[i]; + continue; + } + dp[i][0] = Math.max(dp[i-1][0], + dp[i-1][1] + prices[i]); + dp[i][1] = Math.max(dp[i-1][1], + dp[i-1][0] - prices[i]); + } + return dp[n - 1][0]; +} + +// 空间复杂度优化版本 +int maxProfit_k_inf(int[] prices) { + int n = prices.length; + int dp_i_0 = 0, dp_i_1 = Integer.MIN_VALUE; + for (int i = 0; i < n; i++) { + int temp = dp_i_0; + dp_i_0 = Math.max(dp_i_0, dp_i_1 + prices[i]); + dp_i_1 = Math.max(dp_i_1, temp - prices[i]); + } + return dp_i_0; +} +``` + +- k == 2 + +```java +// 原始版本 +int maxProfit(int[] prices) { + int max_k = 2, n = prices.length; + int[][][] dp = new int[n][max_k + 1][2]; + for (int i = 0; i < n; i++) { + for (int k = max_k; k >= 1; k--) { + if (i - 1 == -1) { + // 处理 base case + dp[i][k][0] = 0; + dp[i][k][1] = -prices[i]; + continue; + } + dp[i][k][0] = Math.max(dp[i-1][k][0], + dp[i-1][k][1] + prices[i]); + dp[i][k][1] = Math.max(dp[i-1][k][1], + dp[i-1][k-1][0] - prices[i]); + } + } + // 穷举了 n × max_k × 2 个状态，正确。 + return dp[n - 1][max_k][0]; +} + +// 空间复杂度优化版本 +int maxProfit_k_2(int[] prices) { + // base case + int dp_i10 = 0, dp_i11 = Integer.MIN_VALUE; + int dp_i20 = 0, dp_i21 = Integer.MIN_VALUE; + for (int price : prices) { + dp_i20 = Math.max(dp_i20, dp_i21 + price); + dp_i21 = Math.max(dp_i21, dp_i10 - price); + dp_i10 = Math.max(dp_i10, dp_i11 + price); + dp_i11 = Math.max(dp_i11, -price); + } + return dp_i20; +} +``` + +- k 为正无穷，但含有交易冷冻期 + +```java +// 原始版本 +int maxProfit_with_cool(int[] prices) { + int n = prices.length; + int[][] dp = new int[n][2]; + for (int i = 0; i < n; i++) { + if (i - 1 == -1) { + // base case 1 + dp[i][0] = 0; + dp[i][1] = -prices[i]; + continue; + } + if (i - 2 == -1) { + // base case 2 + dp[i][0] = Math.max(dp[i-1][0], + dp[i-1][1] + prices[i]); + // i - 2 小于 0 时根据状态转移方程推出对应 base case + dp[i][1] = Math.max(dp[i-1][1], -prices[i]); + // dp[i][1] + // = max(dp[i-1][1], dp[-1][0] - prices[i]) + // = max(dp[i-1][1], 0 - prices[i]) + // = max(dp[i-1][1], -prices[i]) + continue; + } + dp[i][0] = Math.max(dp[i-1][0], + dp[i-1][1] + prices[i]); + dp[i][1] = Math.max(dp[i-1][1], + dp[i-2][0] - prices[i]); + } + return dp[n - 1][0]; +} + +// 空间复杂度优化版本 +int maxProfit_with_cool(int[] prices) { + int n = prices.length; + int dp_i_0 = 0, dp_i_1 = Integer.MIN_VALUE; + int dp_pre_0 = 0; // 代表 dp[i-2][0] + for (int i = 0; i < n; i++) { + int temp = dp_i_0; + dp_i_0 = Math.max(dp_i_0, dp_i_1 + prices[i]); + dp_i_1 = Math.max(dp_i_1, dp_pre_0 - prices[i]); + dp_pre_0 = temp; + } + return dp_i_0; +} +``` + +- k 为正无穷且考虑交易手续费 + +```java +// 原始版本 +int maxProfit_with_fee(int[] prices, int fee) { + int n = prices.length; + int[][] dp = new int[n][2]; + for (int i = 0; i < n; i++) { + if (i - 1 == -1) { + // base case + dp[i][0] = 0; + dp[i][1] = -prices[i] - fee; + // dp[i][1] + // = max(dp[i - 1][1], dp[i - 1][0] - prices[i] - fee) + // = max(dp[-1][1], dp[-1][0] - prices[i] - fee) + // = max(-inf, 0 - prices[i] - fee) + // = -prices[i] - fee + continue; + } + dp[i][0] = Math.max(dp[i - 1][0], + dp[i - 1][1] + prices[i]); + dp[i][1] = Math.max(dp[i - 1][1], + dp[i - 1][0] - prices[i] - fee); + } + return dp[n - 1][0]; +} + +// 空间复杂度优化版本 +int maxProfit_with_fee(int[] prices, int fee) { + int n = prices.length; + int dp_i_0 = 0, dp_i_1 = Integer.MIN_VALUE; + for (int i = 0; i < n; i++) { + int temp = dp_i_0; + dp_i_0 = Math.max(dp_i_0, dp_i_1 + prices[i]); + dp_i_1 = Math.max(dp_i_1, temp - prices[i] - fee); + } + return dp_i_0; +} +``` + +- 指定 k + +```java +int maxProfit_k_any(int max_k, int[] prices) { + int n = prices.length; + if (n <= 0) { + return 0; + } + if (max_k > n / 2) { + // 复用之前交易次数 k 没有限制的情况 + return maxProfit_k_inf(prices); + } + + // base case： + // dp[-1][...][0] = dp[...][0][0] = 0 + // dp[-1][...][1] = dp[...][0][1] = -infinity + int[][][] dp = new int[n][max_k + 1][2]; + // k = 0 时的 base case + for (int i = 0; i < n; i++) { + dp[i][0][1] = Integer.MIN_VALUE; + dp[i][0][0] = 0; + } + + for (int i = 0; i < n; i++) + for (int k = max_k; k >= 1; k--) { + if (i - 1 == -1) { + // 处理 i = -1 时的 base case + dp[i][k][0] = 0; + dp[i][k][1] = -prices[i]; + continue; + } + dp[i][k][0] = Math.max(dp[i-1][k][0], + dp[i-1][k][1] + prices[i]); + dp[i][k][1] = Math.max(dp[i-1][k][1], + dp[i-1][k-1][0] - prices[i]); + } + return dp[n - 1][max_k][0]; +} +``` + +### 矩阵的最小路径和 + +```java +import java.util.*; +public class Solution { + /** + * + * @param matrix int整型二维数组 the matrix + * @return int整型 + */ + public int minPathSum (int[][] matrix) { + // write code here + int m = matrix.length, n = matrix[0].length; + if (m == 0 || n == 0) return 0; + + for (int i = 1; i < m; i++) + matrix[i][0] += matrix[i-1][0]; + for (int i = 1; i < n; i++) + matrix[0][i] += matrix[0][i-1]; + + for (int i = 1; i < m; i++) { + for (int j = 1; j < n; j++) { + matrix[i][j] += + Math.min(matrix[i-1][j], matrix[i][j-1]); + } + } + return matrix[m-1][n-1]; + } +} +``` + +### 编辑距离 + +```java +import java.util.*; + + +public class Solution { + /** + * min edit cost + * @param str1 string字符串 the string + * @param str2 string字符串 the string + * @param ic int整型 insert cost + * @param dc int整型 delete cost + * @param rc int整型 replace cost + * @return int整型 + */ + public int minEditCost (String str1, String str2, + int ic, int dc, int rc) { + // write code here + int len1=str1.length(); + int len2=str2.length(); + char[] char1=str1.toCharArray(); + char[] char2=str2.toCharArray(); + int[][] dp=new int[len1+1][len2+1]; + for(int i=1;i<=len1;i++){ + dp[i][0]=dp[i-1][0]+dc; + } + for(int i=1;i<=len2;i++){ + dp[0][i]=dp[0][i-1]+ic; + } + for(int i=0;i stack = new Stack<>(); + int last = -1; + int maxLen = 0; + for(int i = 0; i < s.length(); i++){ + if(s.charAt(i) == '('){ + stack.push(i); + } else { + if(stack.isEmpty()){ + last = i; + } else { + stack.pop(); + if(stack.isEmpty()){ + maxLen = + Math.max(maxLen, i - last); + } else { + maxLen = + Math.max(maxLen, i - stack.peek()); + } + } + } + } + + return maxLen; + } +} + +// 动态规划 +public int longestValidParentheses2(String s) { + if (s == null || s.length() == 0) + return 0; + int[] dp = new int[s.length()]; + int ans = 0; + for (int i = 1; i < s.length(); i++) { + // 如果是'('直接跳过，默认为0 + if (s.charAt(i) == ')') { + if (s.charAt(i - 1) == '(') + dp[i] = + (i >= 2 ? dp[i - 2] : 0) + 2; + // 说明s.charAt(i - 1)==')' + else if (i - dp[i - 1] > 0 && + s.charAt(i - dp[i - 1] - 1) == '(') { + dp[i] = + (i - dp[i - 1] > 1 ? + dp[i - dp[i - 1] - 2] : 0) + dp[i - 1] + 2; + // 因为加了一个左括号和一个右括号，所以是加2 + } + } + ans = Math.max(ans, dp[i]); + } + return ans; +} +``` + +### 高空扔鸡蛋 + +```java +// 如果棋子碎了，那么棋子的个数K应该减一， +// 搜索的楼层区间应该从[1..N]变为[1..i-1]共i-1层楼； +// 如果棋子没碎，那么棋子的个数K不变， +// 搜索的楼层区间应该从 [1..N]变为[i+1..N]共N-i层楼。 +import java.util.*; +public class Solution { + /** + * 返回最差情况下扔棋子的最小次数 + * @param k int整型 棋子数 + * @param n int整型 楼层数 + * @return int整型 + */ + int[][] memo; + public int solve (int n, int k) { + memo = new int[k + 1][n + 1]; + for(int[] m : memo) { + Arrays.fill(m, -1); + } + return dp(k, n); + } + + // 定义：有K个棋子面对N层楼，最少需要扔 dp(K, N) 次 + int dp(int k, int n) { + // 状态：棋子数k，需要测试的楼层n + if(k == 1) { + return n; + } + // 尝试到底层 + if(n == 0) { + return 0; + } + if(memo[k][n] != -1) { + return memo[k][n]; + } + int res = Integer.MAX_VALUE; + // 寻找第一层到第n层的最少扔的次数 + for(int i = 1; i <= n; i++) { + res = Math.min(res, + // 取决于最差情况（碎了，没碎） + Math.max(dp(k-1, i-1), dp(k, n-i)) + 1); + } + memo[k][n] = res; + return res; + } +} +``` + +### 兑换零钱 + +```java +public class Solution { + /** + * 最少货币数 + * @param arr int整型一维数组 the array + * @param aim int整型 the target + * @return int整型 + */ + public int minMoney (int[] arr, int aim) { + // write code here + //如何使用最少arr元素 构成 aim值 + //dp[i] 代表给定钱数为i的时候最少货币数 + // 就是凑成 i 元钱，需要dp[i] 张arr中面值纸币 + //没办法兑换 arr[i] dp[i] = dp[i] + //可以dp[i] = dp[i - arr[i]] + 1 + //dp[i] = min(dp[i], dp[i-a[j]]) + if(arr == null || arr.length == 0){ + return -1; + } + int[] dp = new int[aim+1]; + for(int i = 0;i<=aim;i++){ + dp[i] = aim+1; + } + + dp[0] = 0; + for(int i = 1;i<=aim;i++){ + for(int j = 0;j< arr.length;j++){ + if(arr[j] <= i){ + //给了一张 3 元钱，小于 需要找零的4 元钱， + // 那 就等于 1 + 需要找零剩下的钱dp[i -arr[j]] 4 - 3 + dp[i] = + Math.min(dp[i], dp[i-arr[j]] +1); + } + } + } + return (dp[aim] > aim) ?-1 : dp[aim]; + } +} +``` + +### 最大正方形 + +1.确定dp[][]数组的含义 + +此题的dp[i][j]，代表以坐标为(i,j)的元素为右下角的正方形的边长。 + +2.状态转移方程 + +dp[i][j]的值取决于dp[i-1][j],dp[i-1][j-1],dp[i][j-1]的最小值 +即左方正方形的边长，左上方正方形的边长，上方正方形的边长三者的最小值。 + +```java +import java.util.*; + +// dp[i][j]，代表以坐标为(i,j)的元素为右下角的正方形的边长 +public class Solution { + /** + * 最大正方形 + * @param matrix char字符型二维数组 + * @return int整型 + */ + public int solve (char[][] matrix) { + // write code here + if(matrix.length ==0 || matrix[0].length == 0) return 0; + int rows = matrix.length; + int cols = matrix[0].length; + int[][] dp = new int[rows][cols]; + int maxSquareLength = 0; + for(int i = 0; i < rows; i++){ + if(matrix[i][0] == '1') dp[i][0] = 1; + } + for(int i = 0; i < cols; i++){ + if(matrix[0][i] == '1') dp[0][i] = 1; + } + for(int i =1; i < rows; i++){ + for(int j = 1; j < cols; j++){ + if(matrix[i][j] == '1'){ + dp[i][j] = + Math.min(Math.min(dp[i-1][j-1], + dp[i-1][j]),dp[i][j-1])+1; + if(dp[i][j] > maxSquareLength) + maxSquareLength = dp[i][j]; + } + } + } + return maxSquareLength*maxSquareLength; + } +} +``` + +### 通配符匹配 + +![](http://image.ouyangsihai.cn/FtLlLxIBxM4nN1yyIi7VqfxsAXMB) + +```java +import java.util.*; +public class Solution { + public boolean isMatch(String s, String p) { + if (p == null || p.isEmpty())return s == null || s.isEmpty(); + int slen = s.length(), plen = p.length(); + boolean[][] dp = new boolean[slen + 1][plen + 1]; + //初始化dp数组,dp[1][0]~dp[s.length][0]默认值flase不需要显式初始化为false + dp[0][0] = true; + //dp[0][1]~dp[0][p.length]只有p的j字符以及前面所有字符都为'*'才为true + for (int j = 1; j <= plen; j++)dp[0][j] = p.charAt(j - 1) == '*' && + dp[0][j - 1]; + //填写dp数组剩余部分 + for (int i = 1; i <= slen; i++) { + for (int j = 1; j <= plen; j++) { + char si = s.charAt(i - 1), pj = p.charAt(j - 1); + if (si == pj || pj == '?') { + dp[i][j] = dp[i - 1][j - 1]; + } else if (pj == '*') { + dp[i][j] = dp[i - 1][j] || dp[i][j - 1]; + } + } + } + return dp[slen][plen]; + } +} +``` + +### 正则表达式匹配 + +![](http://image.ouyangsihai.cn/FsEkqX8hk4n_JgGhpWxZgFGtV5Qs) + +```java +import java.util.*; +public class Solution { + public boolean match (String str, String pattern) { + int n=str.length(); + int m=pattern.length(); + boolean[][] dp=new boolean[n+1][m+1]; + + //初始化 + dp[0][0]=true; + for(int i=1;i<=n;i++){ + dp[i][0]=false; + } + + //分模式串的后一个位置是否为*进行讨论,为*时， + // 将*与前一个位置合并起来进行考虑 + for(int i=0;i<=n;i++){ + for(int j=1;j<=m;j++){ + if(pattern.charAt(j-1)!='*'){ + //当前模式串字符和原串字符匹配 + if(i>0 + &&(str.charAt(i-1)==pattern.charAt(j-1) + ||(pattern.charAt(j-1)=='.'))){ + dp[i][j]=dp[i-1][j-1]; + } + } + else{ + if(j>=2){ + //不管是否匹配，都可以将当前字符绑定上*匹配原串字符0次 + dp[i][j]=dp[i][j-2]; + //当前模式串字符和原串字符匹配 + if(i>0 + &&(str.charAt(i-1)==pattern.charAt(j-2) + ||(pattern.charAt(j-2)=='.'))){ + dp[i][j]=dp[i-1][j]||dp[i][j-2]; + } + } + } + } + } + return dp[n][m]; + } +} +``` + +### 矩阵最长递增路径 + +```java +class Solution { + public int longestIncreasingPath(int[][] matrix) { + int m = matrix.length; + int n = matrix[0].length; + int ans = 0; + int[][] dp = new int[m][n];//储存当前节点最长路径 + for (int i = 0; i < m; i++) { + for (int j = 0; j < n; j++) { + if (dp[i][j] == 0) { + ans = Math.max(ans, dfs(matrix, dp, i, j)); + } + } + } + return ans; + } + public int dfs(int[][] matrix , int[][] dp, int i , int j){ + if (dp[i][j] == 0) { + int dir1 = 0, dir2 = 0, dir3 = 0, dir4 = 0; + if (i > 0 && matrix[i - 1][j] > matrix[i][j]) { + dir1 = dfs(matrix, dp, i - 1, j); + } + if (j > 0 && matrix[i][j - 1] > matrix[i][j]) { + dir2 = dfs(matrix, dp, i, j - 1); + } + if (i < matrix.length - 1 + && matrix[i + 1][j] > matrix[i][j]) { + dir3 = dfs(matrix, dp, i + 1, j); + } + if (j < matrix[0].length - 1 + && matrix[i][j + 1] > matrix[i][j]) { + dir4 = dfs(matrix, dp, i, j + 1); + } + //选出四个方向的最长子串，加1后赋值给当前节点 + dp[i][j] = 1 + Math.max(dir1, + Math.max(dir2, Math.max(dir3, dir4))); + } + return dp[i][j]; + } +} +``` + +### 最长上升子序列 + +- 返回长度 + +```java +import java.util.*; + + +public class Solution { + /** + * 代码中的类名、方法名、参数名已经指定，请勿修改，直接返回方法规定的值即可 + * + * 给定数组的最长严格上升子序列的长度。 + * @param arr int整型一维数组 给定的数组 + * @return int整型 + */ + public int LIS (int[] arr) { + // write code here + int len = arr.length; + if (arr == null && len == 0){ + return 0; + } + int maxLen = 0; + int[] dp = new int[len]; + Arrays.fill(dp, 1); + for (int i = 1; i < len; i++) { + for (int j = i-1; j >=0 ; j--) { + if (arr[i]> arr[j]){ + dp[i] = Math.max(dp[i],dp[j]+1); + } + } + maxLen = Math.max(maxLen,dp[i]); + } + return maxLen; + } +} +``` + +- 返回字符串 + +// 方法一：dp +状态定义：dp[i]表示以i位置元素结尾的最长上升子序列长度。 +状态初始化：以每个位置结尾的上升子序列长度至少为1。 +状态转移：遍历arr数组，假设当前位置为i， +比较当前位置i之前的每一个元素与当前位置元素的大小， +如果小于当前位置元素arr[i]，说明可以接在arr前面。 +即 dp[i]=Math.max(dp[i],dp[j]+1)。 + +// 方法二：dp+数组 +与方法一相同的是，也需要建立一个dp数组找到每一个位置对应的最长上升子序列长度， +最后再通过逆序遍历arr数组的方式，找到每一个长度对应的那个元素，赋值给结果序列。 +不过确定dp数组的方式有所不同。 + +为了找到最长的上升子序列，我们可以维护一个单调递增的数组tail记录当前的最长上升子序列， +如果后面出现的数arr[i]比tail数组末尾元素大，则可以直接加在后面； +如果不是，则找到tail数组中第一个大于等于arr[i]的元素位置， +并将该位置的元素替换为arr[i]，因为在长度相同的情况下，当前值越小，则后面出现更长子序列的概率越大。 + +```java +// 方法一：dp +public class Solution { + public int[] LIS (int[] arr) { + int n=arr.length; + //dp[i]表示以i位置元素结尾的最长上升子序列长度 + int[] dp=new int[n+1]; + //初始化为1 + Arrays.fill(dp,1); + //记录最长子序列的长度 + int len=0; + for(int i=0;i=0;i--){ + if(dp[i]==len){ + res[--len]=arr[i]; + } + return res; + } +} + +// 方法二：dp+二分 +public class Solution { + public int[] LIS (int[] arr) { + int n=arr.length; + //维护一个单调递增tail数组 + int[] tail=new int[n]; + //dp[i]表示以i位置结尾的最长上升子序列长度 + int[] dp=new int[n]; + //最长上升子序列长度 + int len=0; + for(int i=0;i=0;i--){ + if(dp[i]==len){ + res[--len]=arr[i]; + } + } + return res; + } + + //二分法找tail数组中第一个大于等于arr[i]的元素位置 + private int search(int[] nums,int len,int k){ + int low=0,high=len-1; + while(low=k){ + high=mid; + } + //否则排除mid以及mid往左的所有元素 + else{ + low=mid+1; + } + } + return low; + } +} +``` + +### 目标和（完全背包） + +```java +public class Solution { + public int findTargetSumWays (int[] nums, int target) { + //边界情况判断 + int n=nums.length; + if(n==0) return 0; + //记录累加和 + int sum=0; + //遍历nums数组 + for(int num:nums){ + sum+=num; + } + //计算背包容量 + int V=(sum+target)/2; + //如果为奇数，说明nums数组中找不打和为(sum+target)/2的若干数字 + if((sum+target)%2==1) return 0; + + //dp[j]表示有多少种不同的组合，其累加和为j + int[] dp=new int[V+1]; + //初始化 + dp[0]=1; + for(int i=0;i=nums[i];j--){ + dp[j]+=dp[j-nums[i]]; + } + } + return dp[V]; + } +} +``` + +### 打家劫舍 + +```java +public class Solution { + public int rob (int[] nums) { + // write code here + + // 一些特殊情况的处理 + if (1 == nums.length) { + return nums[0]; + } + if (2 == nums.length) { + return Math.max(nums[0], nums[1]); + } + + int l = nums.length; + int[] dp = new int[l]; + + dp[0] = nums[0]; + dp[1] = Math.max(nums[0], nums[1]); + for (int i = 2; i < l; i++) { + dp[i] = Math.max(dp[i - 2] + + nums[i], dp[i - 1]); + } + return dp[l - 1]; + } +} + +// 圆形情况 +public class Solution { + public int rob (int[] nums) { + int n=nums.length; + //在0到n-2范围内找 + int rob1=getRob(Arrays.copyOfRange(nums,0,n-1)); + //在1到n-1范围内找 + int rob2=getRob(Arrays.copyOfRange(nums,1,n)); + + return Math.max(rob1,rob2); + } + + private int getRob(int[] nums){ + int n=nums.length; + //边界情况处理 + if(n==0) return 0; + if(n==1) return nums[0]; + if(n==2) return Math.max(nums[0],nums[1]); + //定义dp数组 + int[] dp=new int[n]; + //初始化 + dp[0]=nums[0]; + dp[1]=Math.max(nums[0],nums[1]); + for(int i=2;i +如果map中没有当前这个元素，那么dp[i]=dp[i-1]+1 +如果map中存在当前的元素，一开始的想法是 dp[i]=i-map.get(array[i]), +但是这样想有点问题，如果当前的字符串是abba的时候,按照刚才的思路dp[0]=1 dp[1]=2 dp[2]=1 dp[3]=3 +但是dp[3]是错误的，因为中间存在了重复的字符。所以要加一种情况。 +dp[i]=Math.min(dp[i-1]+1,i-map.get(array[i])) + +public class Solution { + /** + * 代码中的类名、方法名、参数名已经指定，请勿修改，直接返回方法规定的值即可 + * + * + * @param s string字符串 + * @return int整型 + */ + public int lengthOfLongestSubstring (String s) { + if(s==null) return 0; + char[]array=s.toCharArray(); + if(array.length==1){ + return 1; + } + int[]dp=new int[array.length]; + int maxLength=1; + HashMapmap=new HashMap<>(); + dp[0]=1; + map.put(array[0],0); + for(int i=1;i= 10 && num <= 26){ + if(i == 1){ + dp[i] += 1; + }else{ + dp[i] += dp[i-2]; + } + } + } + return dp[nums.length()-1]; + + } +``` + +## 二分 + +### 求平方根 + +```java +import java.util.*; + + +public class Solution { + /** + * + * @param x int整型 + * @return int整型 + */ + public int sqrt (int x) { + // write code here + if(x < 2){ + return x; + } + int left = 1; + int right = x / 2; + while(left <= right){ + int mid = left + (right - left) / 2; + if(x / mid == mid){ + return mid; + } else if(x / mid < mid){ + right = mid - 1; + } else if(x / mid > mid){ + left = mid + 1; + } + } + + return right; + } +} +``` + +### 在旋转过的有序数组中寻找目标值 + +```java +public class Solution { + public int search (int[] nums, int target) { + // write code here + if (nums == null || nums.length < 1) { + return -1; + } + if (nums.length == 1) { + return nums[0] == target ? 0 : -1; + } + + int start = 0, end = nums.length - 1; + while (end >= start) { + // 找到 左右指针中间位置 + int mid = (end + start) >> 1; + if (nums[mid] == target) { + return mid; + } + // 在左侧升序数组中 + if (nums[0] <= nums[mid]) { + // 在开头和 mid 之间，那么 右指针则为 mid -1 + if (target >= nums[0] + && target < nums[mid]) { + end = mid -1; + } else { + start = mid + 1; + } + } else { + // 如果在 mid 和end 之间，更新 start 为 mid = 1 + if (target > nums[mid] + && target <= nums[end]) { + start = mid + 1; + } else { + end = mid - 1; + } + } + } + return -1; + } +} +``` + +### 在两个长度相等的排序数组中找到上中位数 + +```java +// 普通 +public class Solution { + public int findMedianinTwoSortedAray (int[] arr1, int[] arr2) { + // write code here + int length1 = arr1.length; + int length2 = arr2.length; + int i=0; + int j=0; + int[] arr = new int[length1+length2]; + int index = 0; + //合并数组 + for(;i>1); + //arr2中位数 + mid2 = l2+((r2-l2)>>1); + int k = r1-l1+1; + if(arr1[mid1] == arr2[mid2]){ + //若两数组中位数相等，整体中位数也是这个 + return arr1[mid1]; + } + else if(arr1[mid1] > arr2[mid2]){ + if(k%2 == 0){//区间元素个数为偶数 + r1 = mid1; //整体中位数在arr1左区间,包括mid1 + l2 = mid2+1; //整体中位数在arr2右区间，不包括mid2 + } + else if(k%2 == 1){ //区间元素个数为奇数 + r1 = mid1; //整体中位数在arr1左区间,包括mid1 + l2 = mid2; //整体中位数在arr2右区间，包括mid2 + } + } + else if (arr1[mid1] < arr2[mid2]){ + if(k%2 == 0){//区间元素个数为偶数 + r2 = mid2; //整体中位数在arr2左区间,包括mid2 + l1 = mid1+1; //整体中位数在arr1右区间，不包括mid1 + } + else if(k%2 == 1){ //区间元素个数为奇数 + r2 = mid2; //整体中位数在arr2左区间,包括mid2 + l1 = mid1; //整体中位数在arr1右区间，包括mid1 + } + } + } + //当区间内只有一个元素时，两个区间中最小值即为整体中位数 + return Math.min(arr1[l1],arr2[l2]); +} +``` + +### 有序矩阵元素查找 + +```java +public class Solution { + public int[] findElement(int[][] mat, int n, int m, int x) { + // write code here + int[] result = new int[2]; + int row = 0; + int col = m - 1; + while(row < n && col >= 0) { + if(mat[row][col] == x) { + result[0] = row; + result[1] = col; + break; + } + if(x > mat[row][col]) { + row ++; + } else { + col --; + } + } + return result; + } +} +``` + +### 二分查找 + +```java +public int binarySearch(int target, int[] nums) { + int left = 0; + int right = nums.length-1; //取最后一个下标 + int mid = 0; + //左下标大于右下标，直接返回-1 + if (left > right || nums.length == 0 || nums == null) { + return -1; + } + // 初始化 right 的赋值是 nums.length - 1， + // 即最后一个元素的索引，而不是 nums.length + while (left <= right) { + mid = left + (right - left) / 2; //如果下标之和除以2有小数，则直接去掉 + if (target == nums[mid]) { + return mid; //找到目标值，然后返回 + } else if (target > nums[mid]) { //目标值大于中间值，向右遍历 + left = mid + 1; //所以向右遍历的第一个下标是：中间下标+1 + } else if (target < nums[mid]) { //目标值小于中间值，向左遍历 + right = mid - 1; //所以向左遍历的最后一个下标是：中间下标-1 + } + } + return -1; //找不到对应目标值，直接返回-1 +} +``` + +```java +// 查找最右值 +public class Solution { + public int upper_bound_search (int n, int v, int[] a) { + // write code here + int left = 0, right = n; + while(left < right){ + int mid = left + (right - left) / 2; + if(a[mid] == v){ + right = mid; + } else if(a[mid] > v){ + right = mid; + } else { + left = mid + 1; + } + } + return left+1; + } +} +``` + +```java +// 查找最左值 +public class Solution { + public int left_bound_search (int[] nums, int target) { + // write code here + if (nums == null || nums.length == 0) { + return -1; + } + int left = 0, right = nums.length - 1; + + while (left < right) { + int mid = (left + right) / 2; + if (nums[mid] >= target) { + right = mid; + } else { + left = mid + 1; + } + } + return nums[right] == target ? right : -1; + } +} +``` + +### 旋转数组的最小数字 + +1.如果mid>right，说明mid-right之间存在被旋转数组，left = mid+1 +2.如果mid array[right]){ + left = mid + 1; + } + else{ + right = right - 1; + } + } + return array[left]; + } +} +``` + +### 数字在升序数组中出现的次数 + +```java +public class Solution { + public int GetNumberOfK(int [] array , int k) { + if(array.length == 0 || k < array[0] + || k > array[array.length-1]){ + return 0; + } + int left = 0; + int right = array.length -1; + int count = 0; + int found = 0; + int mid = -1; + while(left < right){ + mid = (left+right)/2; + if(array[mid] > k){ + right = mid-1; + }else if(array[mid] < k){ + left = mid+1; + }else{ + count++; + found = mid; + break; + } + } + + int prev = mid-1; + int foll = mid+1; + while(prev >= left){ + if(array[prev] == k){ + count++; + prev--; + }else{ + break; + } + } + + while(foll <= right){ + if(array[foll] == k){ + count++; + foll++; + }else{ + break; + } + } + return count; + } +} +``` + +### 峰值 + +本题之所以可以使用二分，使复杂度讲到lgn，是因为题目中的nums[i] != nums[i + 1]条件， +当中间元素mid不是峰时，一定有一边比mid中间值大， +假设右边的值，即mid+1位置的值大于mid的值，则右边一定存在峰， +因为右边的值从mid开始要么是 /\ 这个单调性，要么是 / 这种单调性，两种都一定存在峰 + +```java +import java.util.*; +public class Solution { + public int findPeakElement (int[] nums) { + int left = 0; + int right = nums.length - 1; + //二分法 + while(left < right){ + int mid = (left + right) / 2; + //右边是往下，不一定有坡峰 + if(nums[mid] > nums[mid + 1]) + right = mid; + //右边是往上，一定能找到波峰 + else + left = mid + 1; + } + //其中一个波峰 + return right; + } +} +``` + +## 数组 + +### 数组中只出现一次的数字 + +```java +public class Solution { + + public void FindNumsAppearOnce(int [] array, + int num1[] , int num2[]) { + int num = 0; + for(int i = 0; i < array.length; i++){ + num^=array[i]; + } + + int count = 0; + // 标志位，记录num中的第一个1出现的位置 + for(;count < array.length; count++){ + if((num&(1< set = new HashSet<>(); + for(int i = 0; i < array.length; i++){ + if(!set.add(array[i])){ + set.remove(array[i]); + } + } + + Object[] temp = set.toArray(); + num1[0] = (int)temp[0]; + num2[0] = (int)temp[1]; + }*/ +} + +``` + +### 合并两个有序的数组 + +```java +public class Solution { + public void merge(int A[], int m, int B[], int n) { + int i = m-1, j = n-1, k = m+n-1; + while(i >= 0 && j >= 0){ + if(A[i] > B[j]){ + A[k--] = A[i--]; + } else { + A[k--] = B[j--]; + } + } + + while(j >= 0){ + A[k--] = B[j--]; + } + } +} +``` + +### 子数组最大乘积 + +```java +public class Solution { + public double maxProduct(double[] arr) { + if(arr.length == 0 || arr == null){ + return 0.0; + } + double[] max = new double[arr.length]; + double[] min = new double[arr.length]; + max[0] = min[0] = arr[0]; + for(int i = 1; i < arr.length; i++){ + max[i] = + Math.max(Math.max(max[i-1]*arr[i], + min[i-1]*arr[i]),arr[i]); + min[i] = + Math.min(Math.min(max[i-1]*arr[i], + min[i-1]*arr[i]),arr[i]); + } + + double ans = max[0]; + for(int i = 0; i < max.length; i++){ + if(max[i] > ans){ + ans = max[i]; + } + } + return ans; + } +} + +public int maxProduct (int[] nums) { + int max = nums[0]; + int min = nums[0]; + int result = nums[0]; + for (int i = 1; i < nums.length; i++) { + int t = max; + max = Math.max(nums[i], + Math.max(max * nums[i], min * nums[i])); + min = Math.min(nums[i], + Math.min(t * nums[i], min * nums[i])); + result = Math.max(result,max); + } + return result; +} +``` + +### 数组中最长连续子序列 + +```java +public int MLS(int[] arr) { + if (arr == null || arr.length == 0) + return 0; + int longest = 1;//记录最长的有序序列 + int count = 1;//目前有序序列的长度 + //先对数组进行排序 + Arrays.sort(arr); + for (int i = 1; i < arr.length; i++) { + //跳过重复的 + if (arr[i] == arr[i - 1]) + continue; + //比前一个大1，可以构成连续的序列，count++ + if ((arr[i] - arr[i - 1]) == 1) { + count++; + } else { + //没有比前一个大1，不可能构成连续的， + //count重置为1 + count = 1; + } + //记录最长的序列长度 + longest = Math.max(longest, count); + } + return longest; +} +``` + +### 数组中未出现的最小正整数 + +时间复杂度O(n),空间复杂度O(n)的做法：开辟一个新的数组arr，长度为nums.length+1，遍历nums数组， +如果非负且值小于nums的长度，则把arr[nums[i]]置1。然后遍历辅助数组，找到下标不为1的第一个元素即可。 + +```java +public class Solution { + public int minNumberDisappeared (int[] nums) { + int []arr = new int [nums.length+1]; + for(int i=0;i0){ + arr[nums[i]] =1; + } + } + for(int i=1;i= end){ + return; + } + int mid = start + (end - start)/2; + + mergeSort(array,start,mid); + mergeSort(array,mid + 1,end); + + merge(array,start,mid,end); + } + + public void merge(int[] array,int start,int mid,int end){ + int[] temp = new int[end-start+1]; + int k = 0; + int i = start; + int j = mid + 1; + while(i <= mid && j <= end){ + if(array[i] < array[j]){ + temp[k++] = array[i++]; + } else { + temp[k++] = array[j++]; + res = (res + mid - i + 1) % 1000000007; + } + } + + while(i <= mid){ + temp[k++] = array[i++]; + } + + while(j <= end){ + temp[k++] = array[j++]; + } + + for(k = 0; k < temp.length; k++){ + array[start + k] = temp[k]; + } + } + + + /* + public int InversePairs(int [] array) { + int sum = 0; + for(int i = 0; i < array.length - 1; i++){ + for(int j = i + 1; j < array.length; j++){ + if(array[i] > array[j]){ + sum ++; + } + } + } + return sum % 1000000007; + } + */ +} +``` + +### 调整数组顺序使奇数位于偶数前面 + +```java +// 方法一：先记录下技术的个数，然后遍历数组，用另外一个数组接收奇数和偶数 +import java.util.*; +public class Solution { + public int[] reOrderArray (int[] array) { + // write code here + int[] arr=new int[array.length]; + int num=0; + for(int a:array){ + if((a&1)==1) num++;//奇数 + } + int i=0; + for(int a:array){ + if((a&1)==1){ //奇数 + arr[i++]=a; + }else{ + arr[num++]=a; + } + } + return arr; + } +} + +// 方法二：记录已经是奇数的位置下标（视作为有序区域），然后向后遍历， +// 一经发现是奇数则进行“插入排序”，然后有序区下标加1。 +public class Solution { + public int[] reOrderArray (int[] array) { + // 首先是对数值长度进行特判 + if(array==null||array.length==0) return array; + //记录已经是奇数的位置 + int j=0; + int temp = 0; + for(int i =0;ij){ + //这区间整体向后移动一位 + array[k] = array[k-1]; + k--; + } + //移位之后将对应的值赋值 + array[k] = temp; + j++; + } + } + //返回结果数数组 + return array; + } +} +``` + +### 矩阵乘法 + +```java +import java.util.*; +public class Solution { + public int[][] solve (int[][] a, int[][] b) { + // write code here + //矩阵相乘条件：a的列和b的行必须相等 + //记录a的行、a的列(b的行)、b的列 + int aRow = a.length; + int aColumn = a[0].length; + int bColumn = b[0].length; + //新矩阵行为a的行，列为b的列 + int[][] res = new int[aRow][bColumn]; + for(int i=0; i> result = new ArrayList<>(); + //暂存结果 + List path = new ArrayList<>(); + + public List> permuteUnique(int[] nums) { + boolean[] used = new boolean[nums.length]; + Arrays.fill(used, false); + Arrays.sort(nums); + backTrack(nums, used); + return result; + } + + private void backTrack(int[] nums, boolean[] used) { + if (path.size() == nums.length) { + result.add(new ArrayList<>(path)); + return; + } + for (int i = 0; i < nums.length; i++) { + // used[i - 1] == true，说明同⼀树⽀nums[i - 1]使⽤过 + // used[i - 1] == false，说明同⼀树层nums[i - 1]使⽤过 + // 如果同⼀树层nums[i - 1]使⽤过则直接跳过 + if (i > 0 && nums[i] == nums[i - 1] && used[i - 1] == false) { + continue; + } + //如果同⼀树⽀nums[i]没使⽤过开始处理 + if (used[i] == false) { + used[i] = true;//标记同⼀树⽀nums[i]使⽤过，防止同一树支重复使用 + path.add(nums[i]); + backTrack(nums, used); + //回溯，说明同⼀树层nums[i]使⽤过，防止下一树层重复 + path.remove(path.size() - 1); + used[i] = false;//回溯 + } + } + } +} +``` + +### 岛屿的数量 + +```java +class Solution { + public int numIslands(char[][] grid) { + int count = 0; + for(int i = 0; i < grid.length; i++) { + for(int j = 0; j < grid[0].length; j++) { + if(grid[i][j] == '1'){ + bfs(grid, i, j); + count++; + } + } + } + return count; + } + + public void bfs(char[][] grid, int i, int j){ + Queue list = new LinkedList<>(); + list.add(new int[] { i, j }); + while(!list.isEmpty()){ + int[] cur = list.remove(); + i = cur[0]; j = cur[1]; + if(inArea(i,j,grid) + && grid[i][j] == '1') { + grid[i][j] = '0'; + list.add(new int[] { i + 1, j }); + list.add(new int[] { i - 1, j }); + list.add(new int[] { i, j + 1 }); + list.add(new int[] { i, j - 1 }); + } + } + } + + public boolean inArea(int i, int j, char[][] grid){ + return i >=0 && j >= 0 + && i < grid.length + && j < grid[0].length; + } +} +``` + +### 没有重复项数字的所有排列(全排列) + +```java +public class Demo1 { + ArrayList> res; + + public ArrayList> permute(int[] nums) { + res = new ArrayList>(); + if (nums == null || nums.length < 1) + return res; + //对数组元素进行从小到大排序 + Arrays.sort(nums); + ArrayList list = new ArrayList(); + + solve(list, nums); + + return res; + } + + private void solve(ArrayList list, int[] nums) { + if (list.size() == nums.length) { + res.add(new ArrayList(list)); + return; + } + for (int i = 0; i < nums.length; i++) { + if (!list.contains(nums[i])) { + list.add(nums[i]); + solve(list, nums); + list.remove(list.size() - 1); + } + } + } +} +``` + +### 集合的所有子集 + +```java +import java.util.*; +public class Solution { + public ArrayList> subsets(int[] S) { + ArrayList> res=new ArrayList<>(); + Arrays.sort(S); + LinkedList list=new LinkedList<>(); + dfs(res,list,0,S); + return res; + } + public void dfs(ArrayList> res, + LinkedList list, int k, int[] S){ + res.add(new ArrayList<>(list)); + for(int i=k;i> res; + private boolean[] visited; + + public ArrayList> permute(int[] nums) { + res = new ArrayList<>(); + visited = new boolean[nums.length]; + List list = new ArrayList<>(); + backtrace(nums, list); + return res; + } + + private void backtrace(int[] nums, List list) { + if (list.size() == nums.length) { + res.add(new ArrayList<>(list)); + } + + for (int i = 0; i < nums.length; i++) { + if (visited[i]) continue; + visited[i] = true; + list.add(nums[i]); + backtrace(nums, list); + visited[i] = false; + list.remove(list.size() - 1); + } + } +} +``` + +### N皇后问题 + +```java +public class Solution { + /** + * + * @param n int整型 the n + * @return int整型 + */ + public int Nqueen (int n) { + // write code here + List res=new ArrayList<>(); + char[][] chess=new char[n][n]; + for(int i=0;i res){ + if(row==chess.length){ + res.add(1); + return; + } + for(int col=0;col=0&&j=0&&i>=0;i--,j--){ + if(chess[i][j]=='Q'){ + return false; + } + } + return true; + } +} +``` + +### 把数组字符串转换为 ip 地址 + +回溯法插入'.'，每次可以插入到1个，2个或者3个字符后面，插入3次之后对得到的字符串进行验证 + +```java +public class Solution { + ArrayList res = new ArrayList<>(); + public ArrayList restoreIpAddresses (String s) { + // write code here + if(s.length() == 0) + return res; + //表示当前字符串s，可以从第0个位置开始插入'.' ，还有3个'.'可以插入 + backTrack(s, 0, 3); + return res; + } + + public void backTrack(String s, int start, int cnt){ + if(cnt == 0){ + String[] splits = s.split("\\."); + //没有插入4个合法的小数点 + if(splits.length < 4) + return; + //判断每一位是否合法 + for(String str:splits){ + if(str.length() > 1 && str.charAt(0) == '0') return; //最前面的数字不能为0 + if(Integer.valueOf(str) > 255) return; //每一位都不能大于255 + } + res.add(s); + return; + } + + if(start >= s.length()) return; //没有插完全部的点 就已经超出字符串的范围了 + int len = s.length(); + //每次将一个字符作为一位 + backTrack(s.substring(0,start+1)+'.' + +s.substring(start+1,len), start+2, cnt-1); + //每次将两位字符作为一位 + if(start < len-2) + backTrack(s.substring(0,start+2)+'.' + +s.substring(start+2,len), start+3, cnt-1); + //每次将三位字符作为一位 + if(start < len-3) + backTrack(s.substring(0,start+3)+'.' + +s.substring(start+3,len), start+4, cnt-1); + } +} +``` + +### 加起来和为目标值的组合 + +```java +import java.util.* ; +public class Solution { + public ArrayList> combinationSum2(int[] num, int target) { + Arrays.sort(num) ; + ArrayList> res = new ArrayList<>() ; + help(target , num , 0 , res , new ArrayList()) ; + return res ; + } + public void help(int target , int[] num , int idx , + ArrayList> res , ArrayList tmp) { + if(target == 0) { + res.add(new ArrayList(tmp)) ; + return ; + } + for(int i = idx ; i < num.length ; i ++) { + if(num[i] > target) return ;//剪枝 + if((i > idx && num[i] == num[i-1])) continue ;//去重 + tmp.add(num[i]) ; + help(target-num[i] , num , i + 1 , res , tmp) ;//递归 + tmp.remove(tmp.size() - 1) ;//回溯 + } + } +} +``` + +## 其他 + +### 螺旋矩阵 + +给定一个m x n大小的矩阵（m行，n列），按螺旋的顺序返回矩阵中的所有元素 + +```java +import java.util.*; +public class Solution { + public ArrayList spiralOrder(int[][] matrix) { + ArrayList list = new ArrayList<>(); + + if(matrix.length == 0) { + return list; + } + + int left = 0; + int right = matrix[0].length - 1; + int top = 0; + int bottom = matrix.length - 1; + int x = 0; + + + while(true) { + for(int i = left; i <= right; i++) { //从左到右 + list.add(matrix[top][i]) ; + } + + if(++top > bottom){ + break; + } + for(int i = top; i <= bottom; i++){ + list.add( matrix[i][right]); //从上到下 + } + + if(left > --right){ + break; + } + for(int i = right; i >= left; i--){ + list.add(matrix[bottom][i]); //从右到左 + } + + if(top > --bottom){ + break; + } + for(int i = bottom; i >= top; i--){ + list.add(matrix[i][left]); //从下到上 + } + + if(++left > right){ + break; + } + } + return list; + } +} +``` + +### 顺时针旋转矩阵 + +原矩阵元素的列数变成新矩阵元素的行数: 原矩阵元素的行数是第2行，旋转后元素的列数是从右往左倒数第2列。 +因此对于原矩阵mat[i][j]，旋转后该值应该在新矩阵ans[j][n-i-1]的位置。 + +```java +class Solution { +public: + vector > rotateMatrix(vector > mat, int n) { + // write code here + vector> ans(n,vector(n)); + for(int i=0;i=10){ + sb.append(arr[temp-10]); + } + //小于10，直接加到sb + else{ + sb.append(temp); + } + M/=N; + } + //负数要多加一个负号 + if(f){ + sb.append('-'); + } + //反转后转为字符串返回 + return sb.reverse().toString(); + } +} +``` + +### 反转数字 + +```java +public class Solution { + /** + * + * @param x int整型 + * @return int整型 + */ + public int reverse (int x) { + // write code here + int res = 0; + while(x != 0){ + // 获取最后一位 + int tail = x % 10; + int newRes = res * 10 + tail; + // 如果不等于，说明溢出 + if((newRes - tail) / 10 != res){ + return 0; + } + res = newRes; + x /= 10; + } + + return res; + } +} +``` + +### 大数加法 + +```java +public class Solution { + public String solve (String s, String t){ + int i = s.length() - 1, j = t.length() - 1; + int temp = 0; + StringBuilder out = new Stringbuilder(); + while (i >= 0 || j >= 0 || temp != 0) { + temp += i >= 0 ? s.charAt(i--) - '0' : 0; + temp += j >= 0 ? t.charAt(j--) - '0' : 0; + out.append(temp % 10); + temp = temp / 10; + } + return out.reverse().toString(); + } +} + +public class Solution { + public String solveByJava(String s, String t){ + BigInteger num1 = new BigInteger(s); + BigInteger num2 = new BigInteger(t); + return num1.add(num2).toString(); + } +} +``` + +### 把字符串转换成整数(atoi) + +1、首位空格：通过trim()函数即可处理 +2、正负：通过判断第一位，使用变量储存符号即可 +3、非数字字符：对每一位进行判断，非数字则结束 +4、越界：通过提前预判，判断拼接后是否大于阈值，进行处理 + +```java +public class Solution { + public int StrToInt (String s) { + // write code here + char[] array = s.trim().toCharArray(); + if(array.length==0){ + return 0; + } + int sign = 1; + int res = 0; + int i = 0; + + if(array[i] == '+' || array[i] == '-'){ + sign = array[i++] == '+' ? 1 : -1; + } + while(i < array.length){ + char cur = array[i]; + if(cur < '0' || cur>'9'){ + break; + } + if (res >= Integer.MAX_VALUE / 10) { + if(res > Integer.MAX_VALUE / 10){ + return sign==1 + ? Integer.MAX_VALUE : Integer.MIN_VALUE; + } + if(res == Integer.MAX_VALUE / 10){ + if(sign == 1 && (cur - '0') > 7){ + return Integer.MAX_VALUE; + }else if(sign == -1 && (cur - '0') > 8){ + return Integer.MIN_VALUE; + } + } + } + res = res * 10 + (cur - '0'); + i++; + } + return sign * res; + } +} +``` + +### 最长公共前缀 + +```java +// 方法一：先取第一个字符串当做他们的公共前缀 +// 然后找出他和第2个字符串的公共前缀，然后再用这个找出的公共前缀分别和第3个，第4个……判断 +public String longestCommonPrefix(String[] strs) { + //边界条件判断 + if (strs == null || strs.length == 0) + return ""; + //默认第一个字符串是他们的公共前缀 + String pre = strs[0]; + int i = 1; + while (i < strs.length) { + //不断的截取 + while (strs[i].indexOf(pre) != 0) + pre = pre.substring(0, pre.length() - 1); + i++; + } + return pre; +} + +// 方法二：按照字典序排序之后比较字典序最小的子串和字典序最大的子串的相同部分， +// 得到的最长公共前缀就是所有字符串的最长公共前缀 +public class Solution { + public String longestCommonPrefix (String[] strs) { + int len = strs.length; + if(len==0) return ""; + Arrays.sort(strs); + //枚举第一个最小的子串和最后一个最大的子串 + int i = 0; + String a = strs[0]; + String b = strs[len-1]; + for(i = 0;i < a.length()&&a.charAt(i)==b.charAt(i);i++); + return a.substring(0,i); + } +} +``` + +### 回文数字 + +```java +// 方法一：双指针 +import java.util.*; +public class Solution { + /** + * + * @param x int整型 + * @return bool布尔型 + */ + public boolean isPalindrome (int x) { + if(x<0) return false; + // 转换成字符串 + String xs = String.valueOf(x); + // 利用双指针 + int left = 0; + int right = xs.length()-1; + // 比较字符串的头部和尾部是否相同 + while(left < right){ + // 不相同直接返回 + if(xs.charAt(left) != xs.charAt(right)) return false; + left++; + right--; + } + return true; + } +} + +// 方法二：翻转数字 +public class Solution { + /** + * + * @param x int整型 + * @return bool布尔型 + */ + public boolean isPalindrome (int x) { + // write code here + if(x<0) return false; + int reverse = 0; + int tmp = x; + while(tmp>0){ + int div = tmp%10; + // 判断是否会溢出 + if(reverse >= Integer.MAX_VALUE/10 && div > 7) return false; + // 获得反向数字 + reverse = reverse*10 + div; + tmp = tmp/10; + } + return x == reverse; + } +} +``` + +### 字符串变形（反序，大写） + +利用split切割为String数组 +String数组从后往前遍历，拿到具体的String从0到str.length()遍历，并判断大小写然后转换 +需要注意的地方就是s.split(" ",-1)，limit需要设置为-1来不舍弃最后的空串 + +```java +import java.util.*; + +public class Solution { + public String trans(String s, int n) { + // write code here + String[] strArr = s.split(" ",-1); // 注意这里limit为-1,不舍弃最后的空串 + StringBuilder sb = new StringBuilder(); + for(int i = strArr.length - 1; i >= 0; i--) { + for(int j = 0; j < strArr[i].length(); j++) { + if(Character.isUpperCase(strArr[i].charAt(j))) { + sb.append(Character.toLowerCase(strArr[i].charAt(j))); + } else { + sb.append(Character.toUpperCase(strArr[i].charAt(j))); + } + } + if(i != 0) { + sb.append(" "); + } + } + return sb.toString(); + } +} +``` + +### 最大值（数组拼接最大数） + +```java +import java.util.*; +public class Solution { + /** + * 最大数 + * @param nums int整型一维数组 + * @return string字符串 + */ + public String solve (int[] nums) { + String[] strArr = new String[nums.length]; + for (int i = 0 ; i < nums.length ; i++) { + strArr[i] = String.valueOf(nums[i]); + } + Arrays.sort(strArr, + (o1, o2) -> Integer.parseInt(o2 + o1) - Integer.parseInt(o1 + o2)); + StringBuilder maxString = new StringBuilder(); + if (strArr[0].equals( "0")) { + return "0"; + } + for (int i = 0 ; i < strArr.length; i++) { + maxString.append(strArr[i]); + } + return maxString.toString(); + } +} +``` + +### 验证ip地址 + +```java +public String validIPAddress(String IP) { + return validIPv4(IP) + ? "IPv4" : (validIPv6(IP) ? "IPv6" : "Neither"); +} + +private boolean validIPv4(String IP) { + String[] strs = IP.split("\\.", -1); + if (strs.length != 4) { + return false; + } + + for (String str : strs) { + if (str.length() > 1 && str.startsWith("0")) { + return false; + } + try { + int val = Integer.parseInt(str); + if (!(val >= 0 && val <= 255)) { + return false; + } + } catch (NumberFormatException numberFormatException) { + return false; + } + } + return true; +} + +private boolean validIPv6(String IP) { + String[] strs = IP.split(":", -1); + if (strs.length != 8) { + return false; + } + + for (String str : strs) { + if (str.length() > 4 || str.length() == 0) { + return false; + } + try { + int val = Integer.parseInt(str, 16); + } catch (NumberFormatException numberFormatException) { + return false; + } + } + return true; +} +``` + +### 二进制中1的个数 + +将数字与1进行与运算，返回结果为1则表明数字二进制最后一位是1，通过对不断数字右移运算判断有多少个1。 + +```java +public class Solution { + // replace替换 + public int NumberOf1(int n) { + return Integer.toBinaryString(n).replace("0","").length(); + } + + // 遍历字符串记录 + public int NumberOf1(int n) { + String str = Integer.toBinaryString(n); + int length = str.length(); + int count = 0; + for (int i=0; i>>= 1; + } + return res; + } +} +``` + +### 第一个只出现一次的字符 + +```java +import java.util.*; +public class Solution { + public static int FirstNotRepeatingChar(String str) { + int[] map = new int[58]; + char[] chs = str.toCharArray(); + for(int i = 0; i < chs.length; i++){ + map[chs[i] - 'A'] ++; + } + int res = -1; + for(int i = 0; i < chs.length; i++){ + if(map[chs[i] - 'A'] == 1){ + res = i; + break; + } + } + return res; + } +} +``` + +## 其他编程题（golang、java） + +### 单例模式 + +双重否定单例模式：即可以保证线程的安全性 +（避免两个线程同时进入到 synchronized (Singleton.class)时， +线程1先获取到了锁，释放后，线程2执行，如果没有第二次空的判断，会导致多次创建对象）， +也可以实现只有第一次创建new的时候才会执行到同步代码块中的代码，提高了效率。 + +- java + +```java +// 方法一 +//优点：线程安全，volatile关键词主要是保证多线程之间的可见性， +// 保证线程在每次取值volatile变量都是最新值 +//volatile关键字主要是禁止命令重排序的，但是volatile不是原子性的 +public class Singleton { + private static volatile Singleton instance = null; + private Singleton() {} + public static Singleton getInstance() { + if (null == instance) { + synchronized (Singleton.class) { + if (null == instance) { + instance = new Singleton(); + } + } + } + return instance; + } +} + +// 方法二 +public class Singleton { + private Singleton() {} + private static Singleton getInstance() { + return SingletonHolder.instance; + } + private static class SingletonHolder { + //静态变量值会初始化一次 + private static Singleton instance = new Singleton(); + } +} +``` + +- go + +```go +package main + +import ( + "fmt" + "sync" +) + +var lock = &sync.Mutex{} // 创建互锁 +type Singleton struct {} // 创建结构体 + +var singletonInstance *Singleton // 创建指针 + +func getInstance() *single { + if singletonInstance == nil { //!!!注意这里check nil了两次 + lock.Lock() + defer lock.Unlock() + if singletonInstance == nil { + fmt.Println("创建单例") + singletonInstance = &Singleton{} + } else { + fmt.Println("单例对象已创建") + } + } else { + fmt.Println("单例对象已创建") + } + return singletonInstance +} +``` + +### 实现线程安全的生产者消费者 + +- java + +https://blog.csdn.net/u010983881/article/details/78554671 + +- golang + +https://blog.csdn.net/weixin_50005436/article/details/123065703 + +### 一个10G的文件，里面全部是自然数，一行一个，乱序排列，对其排序。在32位机器上面完成，内存限制为 2G（bitmap原理知道吗？） + +首先，10G文件是不可能一次性放到内存里的。这类问题一般有两种解决方案： + +- 将10G文件分成多个小文件，分别排序，最后合并一个文件； +- 采用bitmap + +如果面试大数据类岗位，可能面试官就想考察你对Mapreduce熟悉程度，要采用第一种merge and sort。 + +如果是算法类岗位，就要考虑bitmap，但需要注意的是bitmap**不能对重复数据进行排序**。这里我们详细介绍一下： + +定量分析一下，32位机器自然数有2^32个，用一个bit来存放一个整数，那么所需的内存是， +`2^32/(8<<20) = 512MB` ，这些数存放在文件中，一行一个，需要20G容量， +所以题目问10G文件，只需要256MB内存就可以完成。 + +bitmap实现具体分为两步：插入一个数，和排序。 + +```go +type BitMap struct { + vec []byte + size int +} + +func New(size int) *BitMap { + return &BitMap{ + size: size, + vec: make([]byte, size), + } +} + +func (bm *BitMap) Set(num int) (ok bool, err error) { + if num/8 >= bm.size { + return false, errors.New("the num overflows the size of bitmap") + } + bm.vec[num/8] |= 1 << (num % 8) + return true, nil +} + +func (bm *BitMap) Exist(num int) bool { + if num/8 >= bm.size { + return false + } + return bm.vec[num/8]&(1<<(num%8)) > 0 +} + +func (bm *BitMap) Sort() (ret []int) { + ret = make([]int, 0) + for i := 0; i < (8 * bm.size); i++ { + if bm.Exist(i) { + ret = append(ret, i) + } + } + return +} +``` + +### 实现使用字符串函数名，调用函数 + +思路：采用反射的Call方法实现。 + +```go +package main +import ( + "fmt" + "reflect" +) + +type Animal struct{ + +} + +func (a *Animal) Eat(){ + fmt.Println("Eat") +} + +func main(){ + a := Animal{} + reflect.ValueOf(&a).MethodByName("Eat").Call([]reflect.Value{}) + +} +``` + +### 负载均衡算法。（一致性哈希） + +```go +package main + +import ( + "fmt" + "sort" + "strconv" +) + +type HashFunc func(key []byte) uint32 + +type ConsistentHash struct { + hash HashFunc + hashvals []int + hashToKey map[int]string + virtualNum int +} + +func NewConsistentHash(virtualNum int, fn HashFunc) *ConsistentHash { + return &ConsistentHash{ + hash: fn, + virtualNum: virtualNum, + hashToKey: make(map[int]string), + } +} + +func (ch *ConsistentHash) AddNode(keys ...string) { + for _, k := range keys { + for i := 0; i < ch.virtualNum; i++ { + conv := strconv.Itoa(i) + hashval := int(ch.hash([]byte(conv + k))) + ch.hashvals = append(ch.hashvals, hashval) + ch.hashToKey[hashval] = k + } + } + sort.Ints(ch.hashvals) +} + +func (ch *ConsistentHash) GetNode(key string) string { + if len(ch.hashToKey) == 0 { + return "" + } + keyhash := int(ch.hash([]byte(key))) + id := sort.Search(len(ch.hashToKey), func(i int) bool { + return ch.hashvals[i] >= keyhash + }) + return ch.hashToKey[ch.hashvals[id%len(ch.hashvals)]] +} + +func main() { + ch := NewConsistentHash(3, func(key []byte) uint32 { + ret, _ := strconv.Atoi(string(key)) + return uint32(ret) + }) + ch.AddNode("1", "3", "5", "7") + testkeys := []string{"12", "4", "7", "8"} + for _, k := range testkeys { + fmt.Printf("k:%s,node:%s\n", k, ch.GetNode(k)) + } +} +``` + +### （Goroutine）有三个函数，分别打印"cat", "fish","dog"要求每一个函数都用一个goroutine，按照顺序打印100次 + +此题目考察channel，用三个无缓冲channel，如果一个channel收到信号则通知下一个。 + +```go +package main + +import ( + "fmt" + "time" +) + +var dog = make(chan struct{}) +var cat = make(chan struct{}) +var fish = make(chan struct{}) + +func Dog() { + <-fish + fmt.Println("dog") + dog <- struct{}{} +} + +func Cat() { + <-dog + fmt.Println("cat") + cat <- struct{}{} +} + +func Fish() { + <-cat + fmt.Println("fish") + fish <- struct{}{} +} + +func main() { + for i := 0; i < 100; i++ { + go Dog() + go Cat() + go Fish() + } + fish <- struct{}{} + + time.Sleep(10 * time.Second) +} +``` + +- Java 实现 + +https://www.cnblogs.com/jyx140521/p/6747750.html + +### 两个协程交替打印10个字母和数字 + +思路：采用channel来协调goroutine之间顺序。 + +主线程一般要waitGroup等待协程退出，这里简化了一下直接sleep。 + +```go +package main + +import ( + "fmt" + "time" +) + +var word = make(chan struct{}, 1) +var num = make(chan struct{}, 1) + +func printNums() { + for i := 0; i < 10; i++ { + <-word + fmt.Println(1) + num <- struct{}{} + } +} +func printWords() { + for i := 0; i < 10; i++ { + <-num + fmt.Println("a") + word <- struct{}{} + } +} + +func main() { + num <- struct{}{} + go printNums() + go printWords() + time.Sleep(time.Second * 1) +} +``` + +- Java 实现 + +```java +package com.lutongnet.util; + +import org.junit.Test; + +import java.util.concurrent.ArrayBlockingQueue; +import java.util.concurrent.BlockingQueue; +import java.util.concurrent.LinkedTransferQueue; +import java.util.concurrent.TransferQueue; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.concurrent.locks.Condition; +import java.util.concurrent.locks.Lock; +import java.util.concurrent.locks.LockSupport; +import java.util.concurrent.locks.ReentrantLock; + +/** + * @author mifei + * @version 1.0.0 + * @description 多线程测试 + * @date 2020-11-28 15:18 + */ +public class CommonThreadTest { + + Thread t1 = null; + Thread t2 = null; + + /** + * 测试Synchronized的wait和notify写法 + */ + @Test + public void testSynchronized() { + Object o = new Object(); + char [] letterArray = "ABCDEFGHIJ".toCharArray(); + char [] numbberArray = "1234567890".toCharArray(); + + t1 = new Thread(()->{ + synchronized (o) { + for (char c: letterArray) { + System.out.println("字母：" + c); + try { + o.notify(); + o.wait(); + } catch (InterruptedException e) { + e.printStackTrace(); + } + } + o.notify(); + } + }); + + t2 = new Thread(()->{ + synchronized (o) { + for (char c: numbberArray) { + System.out.println("数字：" + c); + try { + o.notify(); + o.wait(); + } catch (InterruptedException e) { + e.printStackTrace(); + } + } + o.notify(); + } + }); + + t1.start(); + t2.start(); + } + + /** + * 测试ReenTrantLock写法 + */ + @Test + public void testReenTrantlock() { + char [] letterArray = "ABCDEFGHIJ".toCharArray(); + char [] numberArray = "1234567890".toCharArray(); + + Lock lock = new ReentrantLock(); + Condition letterCondition = lock.newCondition(); + Condition numberCondition = lock.newCondition(); + + new Thread(()->{ + try { + lock.lock(); + for (char c: letterArray) { + System.out.println("字母：" + c); + numberCondition.signal(); + letterCondition.await(); + } + numberCondition.signal(); + } catch (InterruptedException e) { + e.printStackTrace(); + } finally { + lock.unlock(); + } + }, "t1").start(); + + new Thread(()->{ + try { + lock.lock(); + for (char c: numberArray) { + System.out.println("数字：" + c); + letterCondition.signal(); + numberCondition.await(); + } + letterCondition.signal(); + } catch (InterruptedException e) { + e.printStackTrace(); + } finally { + lock.unlock(); + } + }, "t2").start(); + } + + /** + * 测试LockSupport写法 + */ + @Test + public void testLockSupport() { + char [] letterArray = "ABCDEFGHIJ".toCharArray(); + char [] numberArray = "1234567890".toCharArray(); + + t1 = new Thread(()->{ + for (char c: letterArray) { + System.out.println("字母：" + c); + LockSupport.unpark(t2); + LockSupport.park(); + } + }); + + t2 = new Thread(()->{ + for (char c: numberArray) { + LockSupport.park(); + System.out.println("数字：" + c); + LockSupport.unpark(t1); + } + }); + + t1.start(); + t2.start(); + } + + /** + * 测试BlockingQueue写法 + */ + @Test + public void testBlockingQueue() { + char [] letterArray = "ABCDEFGHIJ".toCharArray(); + char [] numberArray = "1234567890".toCharArray(); + + BlockingQueue q1 = new ArrayBlockingQueue(1); + BlockingQueue q2 = new ArrayBlockingQueue(1); + + new Thread(()->{ + for (char c: letterArray) { + System.out.println("字母：" + c); + try { + q1.put("ok"); + q2.take(); + } catch (InterruptedException e) { + e.printStackTrace(); + } + + } + }, "t1").start(); + + new Thread(()->{ + for (char c: numberArray) { + try { + q1.take(); + System.out.println("数字：" + c); + q2.put("ok"); + } catch (InterruptedException e) { + e.printStackTrace(); + } + } + }, "t2").start(); + } + + /** + * 测试AtomicInteger写法 + */ + @Test + public void testAtomicInteger() { + AtomicInteger threadNo = new AtomicInteger(1); + + char [] letterArray = "ABCDEFGHIJ".toCharArray(); + char [] numberArray = "1234567890".toCharArray(); + + new Thread(()->{ + for (char c: letterArray) { + while (threadNo.get() != 1) {} + System.out.println("字母：" + c); + threadNo.set(2); + } + }, "t1").start(); + + new Thread(()->{ + for (char c: numberArray) { + while (threadNo.get() != 2) {} + System.out.println("数字：" + c); + threadNo.set(1); + } + }, "t2").start(); + } + + /** + * 测试TransferQueue写法 + */ + @Test + public void testTransferQueue() { + char [] letterArray = "ABCDEFGHIJ".toCharArray(); + char [] numberArray = "1234567890".toCharArray(); + + TransferQueue queue = new LinkedTransferQueue<>(); + new Thread(()->{ + try { + for (char c : letterArray) { + System.out.println("数字：" + queue.take()); + queue.transfer(c); + } + + } catch (InterruptedException e) { + e.printStackTrace(); + } + }, "t1").start(); + + new Thread(()->{ + try { + for (char c : numberArray) { + queue.transfer(c); + System.out.println("字母：" + queue.take()); + } + + } catch (InterruptedException e) { + e.printStackTrace(); + } + }, "t2").start(); + + } +} +``` + +### 启动 2个groutine 2秒后取消， 第一个协程1秒执行完，第二个协程3秒执行完。 + +思路：采用`ctx, _ := context.WithTimeout(context.Background(), time.Second*2)`实现2s取消。 +协程执行完后通过channel通知，是否超时。 + +```go +package main + +import ( + "context" + "fmt" + "time" +) + +func f1(in chan struct{}) { + + time.Sleep(1 * time.Second) + in <- struct{}{} + +} + +func f2(in chan struct{}) { + time.Sleep(3 * time.Second) + in <- struct{}{} +} + +func main() { + ch1 := make(chan struct{}) + ch2 := make(chan struct{}) + ctx, _ := context.WithTimeout(context.Background(), 2*time.Second) + + go func() { + go f1(ch1) + select { + case <-ctx.Done(): + fmt.Println("f1 timeout") + break + case <-ch1: + fmt.Println("f1 done") + } + }() + + go func() { + go f2(ch2) + select { + case <-ctx.Done(): + fmt.Println("f2 timeout") + break + case <-ch2: + fmt.Println("f2 done") + } + }() + time.Sleep(time.Second * 5) +} +``` + + +### 当select监控多个chan同时到达就绪态时，如何先执行某个任务？ + +可以在子case再加一个for select语句。 + +```go +func priority_select(ch1, ch2 <-chan string) { + for { + select { + case val := <-ch1: + fmt.Println(val) + case val2 := <-ch2: + priority: + for { + select { + case val1 := <-ch1: + fmt.Println(val1) + + default: + break priority + } + } + fmt.Println(val2) + } + } + +} ``` \ No newline at end of file diff --git "a/docs/database/MySQL\351\235\242\350\257\225\351\242\230\344\270\200.md" "b/docs/database/MySQL\351\235\242\350\257\225\351\242\230\344\270\200.md" index 9297b4d..1d84a7c 100644 --- "a/docs/database/MySQL\351\235\242\350\257\225\351\242\230\344\270\200.md" +++ "b/docs/database/MySQL\351\235\242\350\257\225\351\242\230\344\270\200.md" @@ -197,6 +197,10 @@ i++; 如果我们需要避免不可重复读的问题的发生，那么我们可以使用**Next-Key Lock算法**（设置事务的隔离级别为`READ REPEATABLE`）来避免，在MySQL中，不可重复读问题就是Phantom Problem，也就是**幻像问题**。 +#### 幻读 + +幻读本质上也属于不可重复读的情况，会话 A 读取某个范围的数据，会话 B 在这个范围内**插入**新的数据，会话 A 再次读取这个范围的数据，此时读取的结果和和第一次读取的结果不同。 + #### 丢失更新 **丢失更新：** 指的是一个事务的更新操作会被另外一个事务的更新操作所覆盖，从而导致数据的不一致。在当前数据库的任何隔离级别下都不会导致丢失更新问题，要出现这个问题，在多用户计算机系统环境下有可能出现这种问题。 @@ -233,7 +237,37 @@ i++; ![](http://image.ouyangsihai.cn/Fh1arOgS78BnrjBXKwGw8NSP27uM) +### MVCC 实现原理 + +在理解 MVCC 的实现原理之前，需要先带大家了解一下 **版本链**。 + +我们都知道，在 InnoDB 每个事务都有一个唯一的事务 ID（transaction id），该 ID 是在启动一个事务时申请的并且严格顺序递增。 + +另外，数据表中的每行数据都是有多个版本的，每次事务更新都会生成新的版本，并且把本次事务的 transaction id 赋值给这个数据版本的事务 ID（row trx_id）。 + +除此之外，还有一个 roll_pointer指针，该指针 ROLL_PTR 把一个数据行的所有快照版本记录连接起来。 + +undo log 的回滚机制也是依靠这个版本链，每次对记录进行改动，都会记录一条undo日志，每条undo日志也都有一个roll_pointer属性（INSERT操作对应的undo日志没有该属性，因为该记录并没有更早的版本），可以将这些undo日志都连起来，串成一个链表，所以现在的情况就像下图一样： + +![](http://image.ouyangsihai.cn/Fidy__nsyaUj1N3MGfGlu1hjbYMM) + +有了上面的知识储备，所谓的 MVCC（Multi-Version Concurrency Control ，多版本并发控制）指的就是在使用**读已提交（READ COMMITTD）**、**可重复读（REPEATABLE READ）** 这两种隔离级别的事务在执行普通的 SELECT 操作时访问记录的版本链的过程，这样子可以使不同事务的读-写、写-读操作并发执行，从而提升系统性能。 + +这两个隔离级别的一个很大不同就是：生成 ReadView 的时机不同，READ COMMITTD 在每一次进行普通 SELECT 操作前都会生成一个 ReadView，而 REPEATABLE READ 只在第一次进行普通 SELECT 操作前生成一个ReadView，数据的可重复读其实就是 ReadView 的重复使用。 +#### **ReadView** + +MVCC 维护了一个 ReadView 结构，主要包含了当前系统未提交的事务列表 TRX_IDs {TRX_ID_1, TRX_ID_2, ...}，还有该列表的最小值 TRX_ID_MIN 和 TRX_ID_MAX。 + +在进行 SELECT 操作时，根据数据行快照的 TRX_ID 与 TRX_ID_MIN 和 TRX_ID_MAX 之间的关系，从而判断数据行快照是否可以使用： + +- TRX_ID < TRX_ID_MIN，表示该数据行快照时在当前所有未提交事务之前进行更改的，因此可以使用。 +- TRX_ID > TRX_ID_MAX，表示该数据行快照是在事务启动之后被更改的，因此不可使用。 +- TRX_ID_MIN <= TRX_ID <= TRX_ID_MAX，需要根据隔离级别再进行判断： + - 提交读：如果 TRX_ID 在 TRX_IDs 列表中，表示该数据行快照对应的事务还未提交，则该快照不可使用。否则表示已经提交，可以使用。 + - 可重复读：都不可以使用。因为如果可以使用的话，那么其它事务也可以读到这个数据行快照并进行修改，那么当前事务再去读这个数据行得到的值就会发生改变，也就是出现了不可重复读问题。 + +在数据行快照不可使用的情况下，需要沿着 Undo Log 的回滚指针 ROLL_PTR 找到下一个快照，再进行上面的判断。 ### 锁相关 > 数据库中锁机制，说说数据库中锁的类型 @@ -258,10 +292,17 @@ InnoDB存储引擎中存在着不同类型的锁，下面一一介绍一下。 为了允许行锁和表锁共存，实现多粒度锁机制，InnoDB存储引擎支持一种额外的锁方式，就称为**意向锁**，意向锁在 InnoDB 中是**表级锁**，意向锁分为： - - 意向共享锁：表达一个事务想要获取一张表中某几行的共享锁。 - 意向排他锁：表达一个事务想要获取一张表中某几行的排他锁。 +在存在行级锁和表级锁的情况下，事务 T 想要对表 A 加 X 锁，就需要先检测是否有其它事务对表 A 或者表 A 中的任意一行加了锁，那么就需要对表 A 的每一行都检测一次，这是非常耗时的。 + +意向锁在原来的 X/S 锁之上引入了 IX/IS，IX/IS 都是表锁，用来表示一个事务想要在表中的某个数据行上加 X 锁或 S 锁。有以下两个规定： + +- 一个事务在获得某个数据行对象的 S 锁之前，必须先获得表的 IS 锁或者更强的锁； +- 一个事务在获得某个数据行对象的 X 锁之前，必须先获得表的 IX 锁。 + +通过引入意向锁，事务 T 想要对表 A 加 X 锁，只需要先检测是否有其它事务对表 A 加了 X/IX/S/IS 锁，如果加了就表示有其它事务正在使用这个表或者表中某一行的锁，因此事务 T 加 X 锁失败。 另外，这些锁之间的并不是一定可以共存的，有些锁之间是不兼容的，所谓**兼容性**就是指事务 A 获得一个某行某种锁之后，事务 B 同样的在这个行上尝试获取某种锁，如果能立即获取，则称锁兼容，反之叫冲突。 @@ -276,6 +317,8 @@ InnoDB存储引擎中存在着不同类型的锁，下面一一介绍一下。 ![](http://image.ouyangsihai.cn/Fgf-Pg6JPVJ7CmPyrdcow_5q-VZm) +**注意：** 任意 IS/IX 锁之间都是兼容的，因为它们只表示想要对表加锁，而不是真正加锁。 + > MySQL中锁的粒度 在数据库中，锁的粒度的不同可以分为表锁、页锁、行锁，这些锁的粒度之间也是会发生升级的，**锁升级**的意思就是讲当前锁的粒度降低，数据库可以把一个表的1000个行锁升级为一个页锁，或者将页锁升级为表锁，下面分别介绍一下这三种锁的粒度（参考自博客：https://blog.csdn.net/baolingye/article/details/102506072）。 @@ -696,5 +739,45 @@ MyISAM引擎会把表自增主键的最大id记录到数据文件中，做了持 关系型数据库的优势在于支持更加复杂的sql操作、事务支持和使用表结构更加易于维护。 +> binlog、redo log和undo log + +redo log（重做日志）是InnoDB存储引擎独有的，它让MySQL拥有了崩溃恢复能力。 + +比如 MySQL 实例挂了或宕机了，重启时，InnoDB存储引擎会使用redo log恢复数据，保证数据的**持久性与完整性**。 + +redo log 记录的是数据的物理变化。 + + +binlog 记录了数据库表结构和表数据变更，比如update/delete/insert/truncate/create。它不会记录select（因为这没有对表没有进行变更），存储着每条变更的SQL语句（当然从下面的图看来看，不止SQL，还有XID「事务Id」等等）。 + +主要有两个作用：**复制和恢复数据** + +- MySQL在公司使用的时候往往都是一主多从结构的，从服务器需要与主服务器的数据保持一致，这就是通过binlog来实现的 + +- 数据库的数据被干掉了，我们可以通过binlog来对数据进行恢复。 + +undo log主要有两个作用：**回滚和多版本控制(MVCC)** + +在数据修改的时候，不仅记录了redo log，还记录undo log，如果因为某些原因导致事务失败或回滚了，可以用undo log进行回滚 + +undo log 主要存储的也是**逻辑日志**，比如我们要insert一条数据了，那undo log会记录的一条对应的delete日志。我们要update一条记录时，它会记录一条对应相反的update记录。 + +这也应该容易理解，毕竟回滚嘛，跟需要修改的操作相反就好，这样就能达到回滚的目的。因为支持回滚操作，所以我们就能保证**原子性**。 + +> mysql 优化思路 + +https://mp.weixin.qq.com/s/jtuLb8uAIHJNvNpwcIZfpA + +https://www.cnblogs.com/jay-huaxiao/p/12995510.html + +> mysql 语法和复杂语句练习题 + +- 常用语法 + +https://www.jb51.net/article/156898.htm +www.cyc2018.xyz/算法/基础/算法 - 排序.html +- 练习题 +https://www.jianshu.com/p/476b52ee4f1b +www.cyc2018.xyz/算法/基础/算法 - 排序.html diff --git "a/docs/golang/\351\235\242\350\257\225\351\242\230/golang\351\235\242\350\257\225\351\242\230\346\225\264\347\220\206-\345\276\256\344\277\241\345\256\214\346\225\264.md" "b/docs/golang/\351\235\242\350\257\225\351\242\230/golang\351\235\242\350\257\225\351\242\230\346\225\264\347\220\206-\345\276\256\344\277\241\345\256\214\346\225\264.md" new file mode 100644 index 0000000..2ec987f --- /dev/null +++ "b/docs/golang/\351\235\242\350\257\225\351\242\230/golang\351\235\242\350\257\225\351\242\230\346\225\264\347\220\206-\345\276\256\344\277\241\345\256\214\346\225\264.md" @@ -0,0 +1,835 @@ +> ❝ +> +> 原文: https://zhuanlan.zhihu.com/p/519979757，作者：沪猿小韩。为适于阅读，部分样式及内容有做简单修改。 +> +> ❞ + +# 前言 + +文章部分题目来源于网络，答案系个人结合5月份面试了近30家公司整理所得，最后附录参考原文链接，如有遗漏的原文出处请联系本人。不对之处望批评指正，答案需要加上自己的思考，最好是代码实践下。 + +参与过面试的企业有：zg人寿，睿科lun,qi猫，yun汉商城，zi节跳动，特斯la，虾P，chuan音，qi安信，ai立信等大大小小企业近30家，BAT简历都过不了。 + +## 面试建议 + +### 技术部分 + +1）算法部分，刷LeetCode就完事了,这是一个长期的过程，短期突击没啥效果，因为题目太多了。 + +2）语言基础，细分为： + +* golang基础及原理，就是本文主要内容了； +* mysql基础及原理； +* redis基础及原理; +* kafka或其他消息中间件（如果没用过，需要了解大概的底层原理及结构）； +* linux常用的命令，比如定时脚本几个参数时间分别代表啥，文件权限需要搞清楚，进程内存占用命令；小公司还要懂一些前端的知识，因为他们希望你什么都会。 + +3）项目经验，可以搞一个基于gin的后端接口服务的web框架，一般会问你怎么实现的；以及微服务了解一下。 + +### 非技术部分 + +1）因为上海5月份居家办公，远程面试，这些题目准备一份，遇到卡壳的题目完全可以参考你准备好的答案，因为视频面试你眼睛是看着面试官还是题目是不太容易区分的（把题目窗口置顶）。 + +2）HR面也可以完全准备一份可能问到的问题的答案，并不是说你不会回答，而是会让你的表达更顺畅，其次也说明你是有备而来的，我在某拉公司面试就吃了这个亏，技术通过，HR说我的表达能力不行（后续我也会把这个模板分享出来，感谢我媳妇充当面试官，以及指导如何高情商的回答HR的问题）。 + +3）可以自己录音面试回答，看看自己的语气、音量，顺畅度，如果自己听了都不舒服，面试官可能也不舒服。 + +## 一、基础部分 + +#### 1、golang 中 make 和 new 的区别？（基本必问） + +共同点：给变量分配内存 + +不同点： + +* 作用变量类型不同，new给string，int和数组分配内存，make给切片，map，channel分配内存； + +* 返回类型不一样，new返回指向变量的指针，make返回变量本身； + +* new 分配的空间被清零。make 分配空间后，会进行初始化； + +* 字节的面试官还说了另外一个区别，就是分配的位置，在堆上还是在栈上？这块我比较模糊，大家可以自己探究下，我搜索出来的答案是golang会弱化分配的位置的概念，因为编译的时候会自动内存逃逸处理，懂的大佬帮忙补充下：make、new内存分配是在堆上还是在栈上？ + +#### string 底层数据结构 + +```go +// from: string.go 在GoLand IDE中双击shift快速找到 +type stringStruct struct { + array unsafe.Pointer // 指向一个 [len]byte 的数组 + length int // 长度 +} +``` + +#### []string 和 []byte 的区别 + +string + +1 .是一个指针，指向某个数组的首地址 +[]byte + +1 .是一个切片slice。一个封装了数组的结构体 +2 .slice结构 +```go +type slice struct { + array unsafe.Pointer + len int + cap int +``` +使用场景 + +1 .想要在本身原地修改，就只能使用[]byte +2 .string不能为nil,想要返回nil表达特殊含义，只能使用[]byte +3 .string可以直接比较，而[]byte不可以，所以[]byte不可以当map的key值。 +4 .因为无法修改string中的某个字符，需要粒度小到操作一个字符时，用[]byte +5 .[]byte切片这么灵活，想要用切片的特性就用[]byte +6 .需要大量字符串处理的时候用[]byte，性能好很多 +区别 + +1 .string的指针指向的内容是不可以改变的，所以每次更改一次字符串，都需要重新分配内存。之前的内存还需要GC收回，这是导致string效率底下的根本原因 +2 .如果我们保存的字符在 ASCII 表的,比如[0-1, a-z,A-Z..]直接可以保存到 byte +3 .如果我们保存的字符对应码值大于 255,这时我们可以考虑使用 int 类型保存 + +#### 2、数组和切片的区别 （基本必问） + +相同点： + +* 只能存储一组相同类型的数据结构 + +* 都是通过下标来访问，并且有容量长度，长度通过 len 获取，容量通过 cap 获取 + +区别： + +* 数组是定长，访问和复制不能超过数组定义的长度，否则就会下标越界，切片长度和容量可以自动扩容 + +* 数组是值类型，切片是引用类型，每个切片都引用了一个底层数组，切片本身不能存储任何数据，都是这底层数组存储数据，所以修改切片的时候修改的是底层数组中的数据。切片一旦扩容，指向一个新的底层数组，内存地址也就随之改变 + +简洁的回答： + +1）定义方式不一样 2）初始化方式不一样，数组需要指定大小，大小不改变 3）函数的传递方式不一样，数组传递的是值，切片传的是地址。 + +数组的定义 + +```go +var a1 [3]int + +var a2 [...]int{1,2,3} +``` + +切片的定义 + +```go +var a1 []int + +var a2 :=make([]int,3,5) +``` + +数组的初始化 + +```go +a1 := [...]int{1,2,3} + +a2 := [5]int{1,2,3} +``` + +切片的初始化 + +```go +b:= make([]int,3,5) +``` +#### 3、for range 的时候它的地址会发生变化么？ + +答：在 `for a,b := range c` 遍历中， a 和 b 在内存中只会存在一份，即之后每次循环时遍历到的数据都是以值覆盖的方式赋给 a 和 b，a，b 的内存地址始终不变。由于有这个特性，**「for 循环里面如果开协程，不要直接把 a 或者 b 的地址传给协程」**。解决办法：在每次循环时，创建一个临时变量。 + +#### 4、go defer，多个 defer 的顺序，defer 在什么时机会修改返回值？ + +作用：defer延迟函数，释放资源，收尾工作；如释放锁，关闭文件，关闭链接；捕获panic; + +避坑指南：defer函数紧跟在资源打开后面，否则defer可能得不到执行，导致内存泄露。 + +多个 defer 调用顺序是 LIFO（后入先出），defer后的操作可以理解为压入栈中 + +解析：函数的 return 语句并不是原子级的，实际上 return 语句只代理汇编指令 ret。defer 语句是在返回前执行，所以返回过程是：「设置返回值—>执行defer—>ret」。defer可以修改函数最终返回值，修改时机：有名返回值或者函数返回指针 参考：[Go高阶指南07，一文搞懂 defer 实现原理)](https://mp.weixin.qq.com/s?__biz=Mzk0NzI3Mjk1Mg==&mid=2247484683&idx=1&sn=262b205caeef06489e5ac8cf84d44112&chksm=c378289cf40fa18aef1d26e1437232b6b20a2f1f7129951d3b094eefa04007ee3fcd0af4655f&token=1319045915&lang=zh_CN&scene=21#wechat_redirect) + +有名返回值 + +```go +func b() (i int) { + defer func() { + i++ + fmt.Println("defer2:", i) + }() + defer func() { + i++ + fmt.Println("defer1:", i) + }() + return i //或者直接写成return +} +func main() { + fmt.Println("return:", b()) +} + +//运行结果： +//defer1: 1 +//defer2: 2 +//return: 2 +``` + +函数返回指针 + +```go +func c() *int { + var i int + defer func() { + i++ + fmt.Println("defer2:", i) + }() + defer func() { + i++ + fmt.Println("defer1:", i) + }() + return &i +} +func main() { + fmt.Println("return:", *(c())) +} + +//运行结果： +//defer1: 1 +//defer2: 2 +//return: 2 +``` +#### 5、uint 类型溢出问题 + +超过最大存储值如uint8最大是255 + +var a uint8 =255 + +var b uint8 =1 + +a+b = 0总之类型溢出会出现难以意料的事 + +![图片](data:image/gif;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQImWNgYGBgAAAABQABh6FO1AAAAABJRU5ErkJggg==) +#### 6、能介绍下 rune 类型吗？ + +相当int32 + +golang中的字符串底层实现是通过byte数组的，中文字符在unicode下占2个字节，在utf-8编码下占3个字节，而golang默认编码正好是utf-8 + +byte 等同于int8，常用来处理ascii字符 + +rune 等同于int32,常用来处理unicode或utf-8字符 + +![图片](https://mmbiz.qpic.cn/mmbiz_png/3wgqfEribn6fXH7I19WrA9zDKjjmfnh6uvufYzu884pVVTs93HTicKncwIbXWzxftNmicFZDkkP6bqdojwN5LicfXw/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1) +#### 7、 golang 中解析 tag 是怎么实现的？反射原理是什么？(中高级肯定会问，比较难，需要自己多去总结) + +参考如下连接golang中struct关于反射tag (https://blog.csdn.net/paladinosment/article/details/42570937) + +```go +type User struct { + name string `json:name-field` + age int +} +func main() { + user := &User{"John Doe The Fourth", 20} + + field, ok := reflect.TypeOf(user).Elem().FieldByName("name") + if !ok { + panic("Field not found") + } + fmt.Println(getStructTag(field)) +} + +func getStructTag(f reflect.StructField) string { + return string(f.Tag) +} +``` + +o 中解析的 tag 是通过反射实现的，反射是指计算机程序在运行时（Run time）可以访问、检测和修改它本身状态或行为的一种能力或动态知道给定数据对象的类型和结构，并有机会修改它。反射将接口变量转换成反射对象 Type 和 Value；反射可以通过反射对象 Value 还原成原先的接口变量；反射可以用来修改一个变量的值，前提是这个值可以被修改；tag是啥:结构体支持标记，name string `json:name-field` 就是 `json:name-field` 这部分 + +gorm json yaml gRPC protobuf gin.Bind()都是通过反射来实现的 + +#### 8、调用函数传入结构体时，应该传值还是指针？（Golang 都是传值） + +Go 的函数参数传递都是值传递。所谓值传递：指在调用函数时将实际参数复制一份传递到函数中，这样在函数中如果对参数进行修改，将不会影响到实际参数。参数传递还有引用传递，所谓引用传递是指在调用函数时将实际参数的地址传递到函数中，那么在函数中对参数所进行的修改，将影响到实际参数 + +因为 Go 里面的 map，slice，chan 是引用类型。变量区分值类型和引用类型。 +所谓值类型：变量和变量的值存在同一个位置。 +所谓引用类型：变量和变量的值是不同的位置，变量的值存储的是对值的引用。 +但并不是 map，slice，chan 的所有的变量在函数内都能被修改，不同数据类型的底层存储结构和实现可能不太一样，情况也就不一样。 + +#### 9、讲讲 Go 的 slice 底层数据结构和一些特性？ + +答：Go 的 slice 底层数据结构是由一个 array 指针指向底层数组，len 表示切片长度，cap 表示切片容量。slice 的主要实现是扩容。对于 append 向 slice 添加元素时，假如 slice 容量够用，则追加新元素进去，slice.len++，返回原来的 slice。当原容量不够，则 slice 先扩容，扩容之后 slice 得到新的 slice，将元素追加进新的 slice，slice.len++，返回新的 slice。对于切片的扩容规则：当切片比较小时（容量小于 1024），则采用较大的扩容倍速进行扩容（新的扩容会是原来的 2 倍），避免频繁扩容，从而减少内存分配的次数和数据拷贝的代价。当切片较大的时（原来的 slice 的容量大于或者等于 1024），采用较小的扩容倍速（新的扩容将扩大大于或者等于原来 1.25 倍），主要避免空间浪费，网上其实很多总结的是 1.25 倍，那是在不考虑内存对齐的情况下，实际上还要考虑内存对齐，扩容是大于或者等于 1.25 倍。 + +（关于刚才问的 slice 为什么传到函数内可能被修改，如果 slice 在函数内没有出现扩容，函数外和函数内 slice 变量指向是同一个数组，则函数内复制的 slice 变量值出现更改，函数外这个 slice 变量值也会被修改。如果 slice 在函数内出现扩容，则函数内变量的值会新生成一个数组（也就是新的 slice，而函数外的 slice 指向的还是原来的 slice，则函数内的修改不会影响函数外的 slice。） + +#### 10、讲讲 Go 的 select 底层数据结构和一些特性？（难点，没有项目经常可能说不清，面试一般会问你项目中怎么使用select） + +答：go 的 select 为 golang 提供了多路 IO 复用机制，和其他 IO 复用一样，用于检测是否有读写事件是否 ready。linux 的系统 IO 模型有 select，poll，epoll，go 的 select 和 linux 系统 select 非常相似。 + +select 结构组成主要是由 case 语句和执行的函数组成 select 实现的多路复用是：每个线程或者进程都先到注册和接受的 channel（装置）注册，然后阻塞，然后只有一个线程在运输，当注册的线程和进程准备好数据后，装置会根据注册的信息得到相应的数据。 + +select 的特性 + +* select 操作至少要有一个 case 语句，出现读写 nil 的 channel 该分支会忽略，在 nil 的 channel 上操作则会报错。 +* select 仅支持管道，而且是单协程操作。 +* 每个 case 语句仅能处理一个管道，要么读要么写。 +* 多个 case 语句的执行顺序是随机的。 +* 存在 default 语句，select 将不会阻塞，但是存在 default 会影响性能。 + +- select 和 channel 的使用场景：https://blog.csdn.net/u011240877/article/details/123611525 + +#### 11、讲讲 Go 的 defer 底层数据结构和一些特性？ + +答：每个 defer 语句都对应一个_defer 实例，多个实例使用指针连接起来形成一个单连表，保存在 gotoutine 数据结构中，每次插入_defer 实例，均插入到链表的头部，函数结束再一次从头部取出，从而形成后进先出的效果。 + +defer 的规则总结： + +* 延迟函数的参数是 defer 语句出现的时候就已经确定了的。 +* 延迟函数执行按照后进先出的顺序执行，即先出现的 defer 最后执行。 +* 延迟函数可能操作主函数的返回值。 +* 申请资源后立即使用 defer 关闭资源是个好习惯。 + +#### 12、单引号，双引号，反引号的区别？ + +单引号，表示byte类型或rune类型，对应 uint8和int32类型，默认是 rune 类型。byte用来强调数据是raw data，而不是数字；而rune用来表示Unicode的code point。 + +双引号，才是字符串，实际上是字符数组。可以用索引号访问某字节，也可以用len()函数来获取字符串所占的字节长度。 + +反引号，表示字符串字面量，但不支持任何转义序列。字面量 raw literal string 的意思是，你定义时写的啥样，它就啥样，你有换行，它就换行。你写转义字符，它也就展示转义字符。 + +# 二、map相关 + +#### 1、map 使用注意的点，是否并发安全？ + +map的类型是map[key]，key类型的ke必须是可比较的，通常情况，会选择内建的基本类型，比如整数、字符串做key的类型。如果要使用struct作为key，要保证struct对象在逻辑上是不可变的。在Go语言中，map[key]函数返回结果可以是一个值，也可以是两个值。map是无序的，如果我们想要保证遍历map时元素有序，可以使用辅助的数据结构，例如orderedmap。 + +第一，一定要先初始化，否则panic + +第二，map类型是容易发生并发访问问题的。不注意就容易发生程序运行时并发读写导致的panic。Go语言内建的map对象不是线程安全的，并发读写的时候运行时会有检查，遇到并发问题就会导致panic。 + +#### 2、map 循环是有序的还是无序的？ + +无序的, map 因扩张⽽重新哈希时，各键值项存储位置都可能会发生改变，顺序自然也没法保证了，所以官方避免大家依赖顺序，直接打乱处理。就是 for range map 在开始处理循环逻辑的时候，就做了随机播种 + +#### 3、 map 中删除一个 key，它的内存会释放么？（常问） + +如果删除的元素是值类型，如int，float，bool，string以及数组和struct，map的内存不会自动释放 + +如果删除的元素是引用类型，如指针，slice，map，chan等，map的内存会自动释放，但释放的内存是子元素应用类型的内存占用 + +将map设置为nil后，内存被回收。 + +这个问题还需要大家去搜索下答案，我记得有不一样的说法，谨慎采用本题答案。 + +#### 4、怎么处理对 map 进行并发访问？有没有其他方案？区别是什么？ + +方式一、使用内置sync.Map，详细参考#### golang sync.map 原理和使用 #### (https://yebd1h.smartapps.cn/pages/blog/index?_swebFromHost=baiduboxapp&blogId=114628932&_swebfr=1) + +方式二、使用读写锁实现并发安全mapgolang线程安全map (https://yebd1h.smartapps.cn/pages/blog/index?_swebFromHost=baiduboxapp&blogId=123259483&_swebfr=1) + +#### 5、 nil map 和空 map 有何不同？ + +1. 可以对未初始化的map进行取值，但取出来的东西是空： + +```go +var m1 map[string]string + +fmt.Println(m1["1"]) +``` + +1. 不能对未初始化的map进行赋值，这样将会抛出一个异常： + +```go +var m1 map[string]string + +m1["1"] = "1" + +panic: assignment to entry in nil map +``` + +1. 通过fmt打印map时，空map和nil map结果是一样的，都为map[]。所以，这个时候别断定map是空还是nil，而应该通过map == nil来判断。 + nil map 未初始化，空map是长度为空 + +#### 6、map 的数据结构是什么？是怎么实现扩容？ + +答：golang 中 map 是一个 kv 对集合。底层使用 hash table，用链表来解决冲突 ，出现冲突时，不是每一个 key 都申请一个结构通过链表串起来，而是以 bmap 为最小粒度挂载，一个 bmap 可以放 8 个 kv。在哈希函数的选择上，会在程序启动时，检测 cpu 是否支持 aes，如果支持，则使用 aes hash，否则使用 memhash。每个 map 的底层结构是 hmap，是有若干个结构为 bmap 的 bucket 组成的数组。每个 bucket 底层都采用链表结构。 + +hmap 的结构如下： + +```go +type hmap struct { + count int // 元素个数 + flags uint8 + B uint8 // 扩容常量相关字段B是buckets数组的长度的对数 2^B + noverflow uint16 // 溢出的bucket个数 + hash0 uint32 // hash seed + buckets unsafe.Pointer // buckets 数组指针 + oldbuckets unsafe.Pointer // 结构扩容的时候用于赋值的buckets数组 + nevacuate uintptr // 搬迁进度 + extra *mapextra // 用于扩容的指针 +} +``` + +map 的容量大小 + +底层调用 makemap 函数，计算得到合适的 B，map 容量最多可容纳 6.52^B 个元素，6.5 为装载因子阈值常量。装载因子的计算公式是：装载因子=填入表中的元素个数/散列表的长度，装载因子越大，说明空闲位置越少，冲突越多，散列表的性能会下降。底层调用 makemap 函数，计算得到合适的 B，map 容量最多可容纳 6.52^B 个元素，6.5 为装载因子阈值常量。装载因子的计算公式是：装载因子=填入表中的元素个数/散列表的长度，装载因子越大，说明空闲位置越少，冲突越多，散列表的性能会下降。 + +触发 map 扩容的条件 + +* 装载因子超过阈值，源码里定义的阈值是 6.5。 +* overflow 的 bucket 数量过多 map 的 bucket 定位和 key 的定位高八位用于定位 bucket，低八位用于定位 key，快速试错后再进行完整对比。 + +#### 7、slices能作为map类型的key吗？ + +当时被问得一脸懵逼，其实是这个问题的变种：golang 哪些类型可以作为map key？ + +答案是：在golang规范中，可比较的类型都可以作为map key；这个问题又延伸到在：golang规范中，哪些数据类型可以比较？ + +不能作为map key 的类型包括： + +slices maps functions + +# 三、context相关 + +#### 1、context 结构是什么样的？context 使用场景和用途？ + +（难，也常常问你项目中怎么用，光靠记答案很难让面试官满意，反正有各种结合实际的问题） + +参考链接：go context详解 (https://www.cnblogs.com/juanmaofeifei/p/14439957.html) + +答：Go 的 Context 的数据结构包含 Deadline，Done，Err，Value，Deadline 方法返回一个 time.Time，表示当前 Context 应该结束的时间，ok 则表示有结束时间，Done 方法当 Context 被取消或者超时时候返回的一个 close 的 channel，告诉给 context 相关的函数要停止当前工作然后返回了，Err 表示 context 被取消的原因，Value 方法表示 context 实现共享数据存储的地方，是协程安全的。context 在业务中是经常被使用的， + +其主要的应用 ： + +1：上下文控制，2：多个 goroutine 之间的数据交互等，3：超时控制：到某个时间点超时，过多久超时。 + +# 四、channel相关 + +#### 1、channel 是否线程安全？锁用在什么地方？ + +![图片](data:image/gif;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQImWNgYGBgAAAABQABh6FO1AAAAABJRU5ErkJggg==) +#### 2、go channel 的底层实现原理 （数据结构） + +![图片](https://mmbiz.qpic.cn/mmbiz_png/3wgqfEribn6fXH7I19WrA9zDKjjmfnh6uAhBkuiacRMG4zqoayxUrPtUZQHoNxic9GOvXljTCre35EUTwzrp88LaQ/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1) + +底层结构需要描述出来，这个简单，buf，发送队列，接收队列，lock。 + +#### 3、nil、关闭的 channel、有数据的 channel，再进行读、写、关闭会怎么样？（各类变种题型，重要） + +![图片](https://mmbiz.qpic.cn/mmbiz_png/3wgqfEribn6fXH7I19WrA9zDKjjmfnh6ucsjGfTGOQjmefjjU9H1cVmvqKCNniaszG72rlBlJsl5yKic2kDG0WVcA/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1) + +还要去了解一下单向channel,如只读或者只写通道常见的异常问题，这块还需要大家自己总结总结，有懂的大佬也可以评论发送答案。 + +#### 4、向 channel 发送数据和从 channel 读数据的流程是什么样的？ + +发送流程： + +![图片](data:image/gif;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQImWNgYGBgAAAABQABh6FO1AAAAABJRU5ErkJggg==) + +接收流程：![图片](data:image/gif;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQImWNgYGBgAAAABQABh6FO1AAAAABJRU5ErkJggg==) + +这个没啥好说的，底层原理，1、2、3描述出来，保证面试官满意。具体的文字描述下面一题有，channel的概念多且复杂，脑海中有个总分的概念，否则你说的再多，面试官也抓不住你说的重点，等于白说。问题5已经为大家总结好了。 + +#### 5、讲讲 Go 的 chan 底层数据结构和主要使用场景 + +答：channel 的数据结构包含 qccount 当前队列中剩余元素个数，dataqsiz 环形队列长度，即可以存放的元素个数，buf 环形队列指针，elemsize 每个元素的大小，closed 标识关闭状态，elemtype 元素类型，sendx 队列下表，指示元素写入时存放到队列中的位置，recv 队列下表，指示元素从队列的该位置读出。recvq 等待读消息的 goroutine 队列，sendq 等待写消息的 goroutine 队列，lock 互斥锁，chan 不允许并发读写。 + +无缓冲和有缓冲区别：管道没有缓冲区，从管道读数据会阻塞，直到有协程向管道中写入数据。同样，向管道写入数据也会阻塞，直到有协程从管道读取数据。管道有缓冲区但缓冲区没有数据，从管道读取数据也会阻塞，直到协程写入数据，如果管道满了，写数据也会阻塞，直到协程从缓冲区读取数据。 + +channel 的一些特点 1）、读写值 nil 管道会永久阻塞 2）、关闭的管道读数据仍然可以读数据 3）、往关闭的管道写数据会 panic 4）、关闭为 nil 的管道 panic 5）、关闭已经关闭的管道 panic + +向 channel 写数据的流程：如果等待接收队列 recvq 不为空，说明缓冲区中没有数据或者没有缓冲区，此时直接从 recvq 取出 G,并把数据写入，最后把该 G 唤醒，结束发送过程；如果缓冲区中有空余位置，将数据写入缓冲区，结束发送过程；如果缓冲区中没有空余位置，将待发送数据写入 G，将当前 G 加入 sendq，进入睡眠，等待被读 goroutine 唤醒； + +向 channel 读数据的流程：如果等待发送队列 sendq 不为空，且没有缓冲区，直接从 sendq 中取出 G，把 G 中数据读出，最后把 G 唤醒，结束读取过程；如果等待发送队列 sendq 不为空，此时说明缓冲区已满，从缓冲区中首部读出数据，把 G 中数据写入缓冲区尾部，把 G 唤醒，结束读取过程；如果缓冲区中有数据，则从缓冲区取出数据，结束读取过程；将当前 goroutine 加入 recvq，进入睡眠，等待被写 goroutine 唤醒； + +使用场景：消息传递、消息过滤，信号广播，事件订阅与广播，请求、响应转发，任务分发，结果汇总，并发控制，限流，同步与异步 + +# 五、GMP相关 + +#### 1、什么是 GMP？（必问） + +答：G 代表着 goroutine，P 代表着上下文处理器，M 代表 thread 线程，在 GPM 模型，有一个全局队列（Global Queue）：存放等待运行的 G，还有一个 P 的本地队列：也是存放等待运行的 G，但数量有限，不超过 256 个。GPM 的调度流程从 go func()开始创建一个 goroutine，新建的 goroutine 优先保存在 P 的本地队列中，如果 P 的本地队列已经满了，则会保存到全局队列中。M 会从 P 的队列中取一个可执行状态的 G 来执行，如果 P 的本地队列为空，就会从其他的 MP 组合偷取一个可执行的 G 来执行，当 M 执行某一个 G 时候发生系统调用或者阻塞，M 阻塞，如果这个时候 G 在执行，runtime 会把这个线程 M 从 P 中摘除，然后创建一个新的操作系统线程来服务于这个 P，当 M 系统调用结束时，这个 G 会尝试获取一个空闲的 P 来执行，并放入到这个 P 的本地队列，如果这个线程 M 变成休眠状态，加入到空闲线程中，然后整个 G 就会被放入到全局队列中。 + +关于 G,P,M 的个数问题，G 的个数理论上是无限制的，但是受内存限制，P 的数量一般建议是逻辑 CPU 数量的 2 倍，M 的数据默认启动的时候是 10000，内核很难支持这么多线程数，所以整个限制客户忽略，M 一般不做设置，设置好 P，M 一般都是要大于 P。 + +#### 2、进程、线程、协程有什么区别？（必问） + +进程：是应用程序的启动实例，每个进程都有独立的内存空间，不同的进程通过进程间的通信方式来通信。 + +线程：从属于进程，每个进程至少包含一个线程，线程是 CPU 调度的基本单位，多个线程之间可以共享进程的资源并通过共享内存等线程间的通信方式来通信。 + +协程：为轻量级线程，与线程相比，协程不受操作系统的调度，协程的调度器由用户应用程序提供，协程调度器按照调度策略把协程调度到线程中运行 + +#### 3、抢占式调度是如何抢占的？ + +基于协作式抢占 + +基于信号量抢占 + +就像操作系统要负责线程的调度一样，Go的runtime要负责goroutine的调度。现代操作系统调度线程都是抢占式的，我们不能依赖用户代码主动让出CPU，或者因为IO、锁等待而让出，这样会造成调度的不公平。基于经典的时间片算法，当线程的时间片用完之后，会被时钟中断给打断，调度器会将当前线程的执行上下文进行保存，然后恢复下一个线程的上下文，分配新的时间片令其开始执行。这种抢占对于线程本身是无感知的，系统底层支持，不需要开发人员特殊处理。 + +基于时间片的抢占式调度有个明显的优点，能够避免CPU资源持续被少数线程占用，从而使其他线程长时间处于饥饿状态。goroutine的调度器也用到了时间片算法，但是和操作系统的线程调度还是有些区别的，因为整个Go程序都是运行在用户态的，所以不能像操作系统那样利用时钟中断来打断运行中的goroutine。也得益于完全在用户态实现，goroutine的调度切换更加轻量。 + +上面这两段文字只是对调度的一个概括，具体的协作式调度、信号量调度大家还需要去详细了解，这偏底层了，大厂或者中高级开发会问。（字节就问了） + +#### 4、M 和 P 的数量问题？ + +p默认cpu内核数 + +M与P的数量没有绝对关系，一个M阻塞，P就会去创建或者切换另一个M，所以，即使P的默认数量是1，也有可能会创建很多个M出来 + +【Go语言调度模型G、M、P的数量多少合适？】 + +详细参考这篇文章Go语言调度模型G、M、P的数量多少合适？ (https://zoyi14.smartapps.cn/pages/note/index?_swebFromHost=baiduboxapp&origin=share&slug=1a50330adf1b&_swebfr=1) + +GMP数量这一块，结论很好记，没用项目经验的话，问了项目中怎么用可能容易卡壳。 + +# 六、锁相关 + +#### 1、除了 mutex 以外还有哪些方式安全读写共享变量？ + +* 将共享变量的读写放到一个 goroutine 中，其它 goroutine 通过 channel 进行读写操作。 + +* 可以用个数为 1 的信号量（semaphore）实现互斥 + +* 通过 Mutex 锁实现 + +#### 2、Go 如何实现原子操作？ + +答：原子操作就是不可中断的操作，外界是看不到原子操作的中间状态，要么看到原子操作已经完成，要么看到原子操作已经结束。在某个值的原子操作执行的过程中，CPU 绝对不会再去执行其他针对该值的操作，那么其他操作也是原子操作。 + +Go 语言的标准库代码包 sync/atomic 提供了原子的读取（Load 为前缀的函数）或写入（Store 为前缀的函数）某个值（这里细节还要多去查查资料）。 + +原子操作与互斥锁的区别 + +* 互斥锁是一种数据结构，用来让一个线程执行程序的关键部分，完成互斥的多个操作。 +* 原子操作是针对某个值的单个互斥操作。 +* Mutex 是悲观锁还是乐观锁？悲观锁、乐观锁是什么？ + +悲观锁 + +悲观锁：当要对数据库中的一条数据进行修改的时候，为了避免同时被其他人修改，最好的办法就是直接对该数据进行加锁以防止并发。这种借助数据库锁机制，在修改数据之前先锁定，再修改的方式被称之为悲观并发控制【Pessimistic Concurrency Control，缩写“PCC”，又名“悲观锁”】。 + +乐观锁 + +乐观锁是相对悲观锁而言的，乐观锁假设数据一般情况不会造成冲突，所以在数据进行提交更新的时候，才会正式对数据的冲突与否进行检测，如果冲突，则返回给用户异常信息，让用户决定如何去做。乐观锁适用于读多写少的场景，这样可以提高程序的吞吐量 + +#### 4、Mutex 有几种模式？ + +1. 正常模式 + +当前的mutex只有一个goruntine来获取，那么没有竞争，直接返回。新的goruntine进来，如果当前mutex已经被获取了，则该goruntine进入一个先入先出的waiter队列，在mutex被释放后，waiter按照先进先出的方式获取锁。该goruntine会处于自旋状态(不挂起，继续占有cpu)。新的goruntine进来，mutex处于空闲状态，将参与竞争。新来的 goroutine 有先天的优势，它们正在 CPU 中运行，可能它们的数量还不少，所以，在高并发情况下，被唤醒的 waiter 可能比较悲剧地获取不到锁，这时，它会被插入到队列的前面。如果 waiter 获取不到锁的时间超过阈值 1 毫秒，那么，这个 Mutex 就进入到了饥饿模式。 + +1. 饥饿模式 + +在饥饿模式下，Mutex 的拥有者将直接把锁交给队列最前面的 waiter。新来的 goroutine 不会尝试获取锁，即使看起来锁没有被持有，它也不会去抢，也不会 spin（自旋），它会乖乖地加入到等待队列的尾部。如果拥有 Mutex 的 waiter 发现下面两种情况的其中之一，它就会把这个 Mutex 转换成正常模式: + +此 waiter 已经是队列中的最后一个 waiter 了，没有其它的等待锁的 goroutine 了；此 waiter 的等待时间小于 1 毫秒。 + +#### 5、goroutine 的自旋占用资源如何解决 + +自旋锁是指当一个线程在获取锁的时候，如果锁已经被其他线程获取，那么该线程将循环等待，然后不断地判断是否能够被成功获取，直到获取到锁才会退出循环。 + +自旋的条件如下： + +* 还没自旋超过 4 次, +* 多核处理器， +* GOMAXPROCS > 1， +* p 上本地 goroutine 队列为空。 + +mutex 会让当前的 goroutine 去空转 CPU，在空转完后再次调用 CAS 方法去尝试性的占有锁资源，直到不满足自旋条件，则最终会加入到等待队列里。 + +# 七、并发相关 + +#### 1、怎么控制并发数？ + +1. 有缓冲通道 + +根据通道中没有数据时读取操作陷入阻塞和通道已满时继续写入操作陷入阻塞的特性，正好实现控制并发数量。 + +```go +func main() { + count := 10 // 最大支持并发 + sum := 100 // 任务总数 + wg := sync.WaitGroup{} //控制主协程等待所有子协程执行完之后再退出。 + + c := make(chan struct{}, count) // 控制任务并发的chan + defer close(c) + + for i:=0; i接口，自动垃圾回收和goroutine等让人**拍案叫绝**的设计。 + +有许多基于Go的优秀项目。Docker，Kubernetes，etcd，deis，flynn，lime，revel等等。Go无疑是**云时代的最好语言**！ + +题外话到此为止，在面试中，我们需要深入了解Go**语言特性**，并适当辅以**源码阅读**（Go源码非常**人性化，注释非常详细，**基本上只要你学过Go就能看懂）来提升能力。常考的点包括：切片，通道，异常处理，Goroutine，GMP模型，字符串高效拼接，指针，反射，接口，sync，go test和相关工具链。 + +一切问题的最权威的回答一定来自**官方**，这里力荐golang官方FAQ，虽然是英文的，但是也希望你花3-4天看完。**从使用者的角度去提问题， 从设计者的角度回答问题**。 + +![](https://pic3.zhimg.com/80/v2-1b6d660f2d2fc3599a2d82ef1245e3ea_1440w.jpg)官方FAQ问题 + [https://golang.org/doc/faq​golang.org/doc/faq](https://link.zhihu.com/?target=https%3A//golang.org/doc/faq) + +**面试题都是来源于网上和自己平时遇到的，但是很少有解答的版本，所以我专门回答了一下，放在专栏。** + +【所有试题已注明来源，侵删】 + +* * * + +## **面试题1** + +来源：[geektutu](https://link.zhihu.com/?target=https%3A//geektutu.com/post/qa-golang.html) + +### 基础语法 + +### 01 `=` 和 `:=` 的区别？ + +=是赋值变量，:=是定义变量。 + +### 02 指针的作用 + +一个指针可以指向任意变量的地址，它所指向的地址在32位或64位机器上分别**固定**占4或8个字节。指针的作用有： + +* 获取变量的值 + + ```go +import fmt + ​ + func main(){ + a := 1 + p := &a//取址& + fmt.Printf("%d\n", *p);//取值* + } +``` + +* 改变变量的值 + + ```go +// 交换函数 + func swap(a, b *int) { + *a, *b = *b, *a + } +``` + +* 用指针替代值传入函数，比如类的接收器就是这样的。 + + ```go +type A struct{} + ​ + func (a *A) fun(){} +``` + +### 03 Go 允许多个返回值吗？ + +可以。通常函数除了一般返回值还会返回一个error。 + +### 04 Go 有异常类型吗？ + +有。Go用error类型代替try...catch语句，这样可以节省资源。同时增加代码可读性： + + ```go +_,err := errorDemo() + if err!=nil{ + fmt.Println(err) + return + } +``` + +也可以用errors.New()来定义自己的异常。errors.Error()会返回异常的字符串表示。只要实现error接口就可以定义自己的异常， + + ```go +type errorString struct { + s string + } + ​ + func (e *errorString) Error() string { + return e.s + } + ​ + // 多一个函数当作构造函数 + func New(text string) error { + return &errorString{text} + } +``` + +### 05 什么是协程（Goroutine） + +协程是**用户态轻量级线程**，它是**线程调度的基本单位**。通常在函数前加上go关键字就能实现并发。一个Goroutine会以一个很小的栈启动2KB或4KB，当遇到栈空间不足时，栈会**自动伸缩**， 因此可以轻易实现成千上万个goroutine同时启动。 + +### 06 ❤ 如何高效地拼接字符串 + +拼接字符串的方式有："+", fmt.Sprintf, strings.Builder, bytes.Buffer, strings.Join + +1 "+" + +使用`+`操作符进行拼接时，会对字符串进行遍历，计算并开辟一个新的空间来存储原来的两个字符串。 + +2 fmt.Sprintf + +由于采用了接口参数，必须要用反射获取值，因此有性能损耗。 + +3 strings.Builder： + +用WriteString()进行拼接，内部实现是指针+切片，同时String()返回拼接后的字符串，它是直接把[]byte转换为string，从而避免变量拷贝。 + +`strings.builder`的实现原理很简单，结构如下： + +```go +type Builder struct { + addr *Builder // of receiver, to detect copies by value + buf []byte // 1 + } +``` + +`addr`字段主要是做`copycheck`，`buf`字段是一个`byte`类型的切片，这个就是用来存放字符串内容的，提供的`writeString()`方法就是像切片`buf`中追加数据： + +```go +func (b *Builder) WriteString(s string) (int, error) { + b.copyCheck() + b.buf = append(b.buf, s...) + return len(s), nil + } +``` + +提供的`String`方法就是将`[]byte`转换为`string`类型，这里为了避免内存拷贝的问题，使用了强制转换来避免内存拷贝： + +```go +func (b *Builder) String() string { + return *(*string)(unsafe.Pointer(&b.buf)) + } +``` + +4 bytes.Buffer + +`bytes.Buffer`是一个一个缓冲`byte`类型的缓冲器，这个缓冲器里存放着都是`byte`。使用方式如下： + +`bytes.buffer`底层也是一个`[]byte`切片，结构体如下： + +```go +type Buffer struct { + buf []byte // contents are the bytes buf[off : len(buf)] + off int // read at &buf[off], write at &buf[len(buf)] + lastRead readOp // last read operation, so that Unread* can work correctly. +} +``` + +因为`bytes.Buffer`可以持续向`Buffer`尾部写入数据，从`Buffer`头部读取数据，所以`off`字段用来记录读取位置，再利用切片的`cap`特性来知道写入位置，这个不是本次的重点，重点看一下`WriteString`方法是如何拼接字符串的： + +```go +func (b *Buffer) WriteString(s string) (n int, err error) { + b.lastRead = opInvalid + m, ok := b.tryGrowByReslice(len(s)) + if !ok { + m = b.grow(len(s)) + } + return copy(b.buf[m:], s), nil +} +``` + +切片在创建时并不会申请内存块，只有在往里写数据时才会申请，首次申请的大小即为写入数据的大小。如果写入的数据小于64字节，则按64字节申请。采用动态扩展`slice`的机制，字符串追加采用`copy`的方式将追加的部分拷贝到尾部，`copy`是内置的拷贝函数，可以减少内存分配。 + +但是在将`[]byte`转换为`string`类型依旧使用了标准类型，所以会发生内存分配： + +```go +func (b *Buffer) String() string { + if b == nil { + // Special case, useful in debugging. + return "" + } + return string(b.buf[b.off:]) +} +``` + +5 strings.join + +`strings.join`也是基于`strings.builder`来实现的,并且可以自定义分隔符，代码如下： + +```go +func Join(elems []string, sep string) string { + switch len(elems) { + case 0: + return "" + case 1: + return elems[0] + } + n := len(sep) * (len(elems) - 1) + for i := 0; i < len(elems); i++ { + n += len(elems[i]) + } + + var b Builder + b.Grow(n) + b.WriteString(elems[0]) + for _, s := range elems[1:] { + b.WriteString(sep) + b.WriteString(s) + } + return b.String() +} +``` + +唯一不同在于在`join`方法内调用了`b.Grow(n)`方法，这个是进行初步的容量分配，而前面计算的n的长度就是我们要拼接的slice的长度，因为我们传入切片长度固定，所以提前进行容量分配可以减少内存分配，很高效。 + +```go +func main(){ + a := []string{"a", "b", "c"} + //方式1： ret := a[0] + a[1] + a[2] + //方式2： ret := fmt.Sprintf("%s%s%s", a[0],a[1],a[2]) + //方式3： var sb strings.Builder + sb.WriteString(a[0]) + sb.WriteString(a[1]) + sb.WriteString(a[2]) + ret := sb.String() + //方式4： buf := new(bytes.Buffer) + buf.Write(a[0]) + buf.Write(a[1]) + buf.Write(a[2]) + ret := buf.String() + //方式5： ret := strings.Join(a,"") +} +``` + +总结： + +strings.Join ≈ strings.Builder > bytes.Buffer > "+" > fmt.Sprintf + +> 参考资料：[字符串拼接性能及原理 | Go 语言高性能编程 | 极客兔兔](https://link.zhihu.com/?target=https%3A//geektutu.com/post/hpg-string-concat.html) + +### 07 什么是 rune 类型 + +ASCII 码只需要 7 bit 就可以完整地表示，但只能表示英文字母在内的128个字符，为了表示世界上大部分的文字系统，发明了 Unicode， 它是ASCII的超集，包含世界上书写系统中存在的所有字符，并为每个代码分配一个标准编号（称为Unicode CodePoint），在 Go 语言中称之为 rune，是 int32 类型的别名。 + +Go 语言中，字符串的底层表示是 byte (8 bit) 序列，而非 rune (32 bit) 序列。 + +```go +sample := "我爱GO" +runeSamp := []rune(sample) +runeSamp[0] = '你' +fmt.Println(string(runeSamp)) // "你爱GO" fmt.Println(len(runeSamp)) // 4 +``` + +### 08 如何判断 map 中是否包含某个 key ？ + +```go +var sample map[int]int +if _, ok := sample[10];ok{ + +}else{ + +} +``` + +### 09 Go 支持默认参数或可选参数吗？ + +不支持。但是可以利用结构体参数，或者...传入参数切片。 + +### 10 defer 的执行顺序 + +defer执行顺序和调用顺序相反，类似于栈后进先出(LIFO)。 + +defer在return之后执行，但在函数退出之前，defer可以修改返回值。下面是一个例子： + +```go +func test() int { + i := 0 + defer func() { + fmt.Println("defer1") + }() + defer func() { + i += 1 + fmt.Println("defer2") + }() + return i +} + +func main() { + fmt.Println("return", test()) +} +// defer2 // defer1 // return 0 +``` + +上面这个例子中，test返回值并没有修改，这是由于Go的返回机制决定的，执行Return语句后，Go会创建一个临时变量保存返回值。如果是有名返回（也就是指明返回值functest()(i int)） + +```go +func test() (i int) { + i = 0 + defer func() { + i += 1 + fmt.Println("defer2") + }() + return i +} + +func main() { + fmt.Println("return", test()) +} +// defer2 // return 1 +``` + +这个例子中，返回值被修改了。对于有名返回值的函数，执行 return 语句时，并不会再创建临时变量保存，因此，defer 语句修改了 i，即对返回值产生了影响。 + +### 11 如何交换 2 个变量的值？ + +对于变量而言`a,b = b,a`； 对于指针而言`*a,*b = *b, *a` + +### 12 Go 语言 tag 的用处？ + +tag可以为结构体成员提供属性。常见的： + +1. json序列化或反序列化时字段的名称 +2. db: sqlx模块中对应的数据库字段名 +3. form: gin框架中对应的前端的数据字段名 +4. binding: 搭配 form 使用, 默认如果没查找到结构体中的某个字段则不报错值为空, binding为 required 代表没找到返回错误给前端 + +### 13 如何获取一个结构体的所有tag？ + +利用反射： + +```go +import reflect +type Author struct { + Name int `json:Name` + Publications []string `json:Publication,omitempty` +} + +func main() { + t := reflect.TypeOf(Author{}) + for i := 0; i < t.NumField(); i++ { + name := t.Field(i).Name + s, _ := t.FieldByName(name) + fmt.Println(name, s.Tag) + } +} +``` + +上述例子中，`reflect.TypeOf`方法获取对象的类型，之后`NumField()`获取结构体成员的数量。 通过`Field(i)`获取第i个成员的名字。 再通过其`Tag` 方法获得标签。 + +### 14 如何判断 2 个字符串切片（slice) 是相等的？ + +reflect.DeepEqual()， 但反射非常影响性能。 + +### 15 结构体打印时，`%v` 和 `%+v` 的区别 + +`%v`输出结构体各成员的值； + +`%+v`输出结构体各成员的**名称**和**值**； + +`%#v`输出结构体名称和结构体各成员的名称和值 + +### 16 Go 语言中如何表示枚举值(enums)？ + +在常量中用iota可以表示枚举。iota从0开始。 + +```go +const ( + B = 1 << (10 * iota) + KiB + MiB + GiB + TiB + PiB + EiB +) +``` + +### 17 空 struct{} 的用途 + +* 用map模拟一个set，那么就要把值置为struct{}，struct{}本身不占任何空间，可以避免任何多余的内存分配。 + +```go +type Set map[string]struct{} + +func main() { + set := make(Set) + + for _, item := range []string{"A", "A", "B", "C"} { + set[item] = struct{}{} + } + fmt.Println(len(set)) // 3 + if _, ok := set["A"]; ok { + fmt.Println("A exists") // A exists + } +} +``` + +* 有时候给通道发送一个空结构体,channel<-struct{}{}，也是节省了空间。 + +```go +func main() { + ch := make(chan struct{}, 1) + go func() { + <-ch + // do something + }() + ch <- struct{}{} + // ... +} +``` + +* 仅有方法的结构体 + +```go +type Lamp struct{} +``` + +### **18 go里面的int和int32是同一个概念吗？** + +不是一个概念！千万不能混淆。go语言中的int的大小是和操作系统位数相关的，如果是32位操作系统，int类型的大小就是4字节。如果是64位操作系统，int类型的大小就是8个字节。除此之外uint也与操作系统有关。 + +int8占1个字节，int16占2个字节，int32占4个字节，int64占8个字节。 + +### 实现原理 + +### 01 init() 函数是什么时候执行的？ + +**简答**： 在main函数之前执行。 + +**详细**：init()函数是go初始化的一部分，由runtime初始化每个导入的包，初始化不是按照从上到下的导入顺序，而是按照解析的依赖关系，没有依赖的包最先初始化。 + +每个包首先初始化包作用域的常量和变量（常量优先于变量），然后执行包的`init()`函数。同一个包，甚至是同一个源文件可以有多个`init()`函数。`init()`函数没有入参和返回值，不能被其他函数调用，同一个包内多个`init()`函数的执行顺序不作保证。 + +执行顺序：import –> const –> var –>`init()`–>`main()` + +一个文件可以有多个`init()`函数！ + +### 02 ❤如何知道一个对象是分配在栈上还是堆上？ + +Go和C++不同，Go局部变量会进行**逃逸分析**。如果**变量离开作用域后没有被引用**，则**优先**分配到栈上，否则分配到堆上。那么如何判断是否发生了逃逸呢？ + +`go build -gcflags '-m -m -l' xxx.go`. + +关于逃逸的可能情况：变量大小不确定，变量类型不确定，变量分配的内存超过用户栈最大值，暴露给了外部指针。 + +### 03 2 个 interface 可以比较吗 ？ + +Go 语言中，interface 的内部实现包含了 2 个字段，类型 `T` 和 值 `V`，interface 可以使用 `==` 或 `!=` 比较。2 个 interface 相等有以下 2 种情况 + +1. 两个 interface 均等于 nil（此时 V 和 T 都处于 unset 状态） +2. 类型 T 相同，且对应的值 V 相等。 + +看下面的例子： + +```go +type Stu struct { + Name string +} + +type StuInt interface{} + +func main() { + var stu1, stu2 StuInt = &Stu{"Tom"}, &Stu{"Tom"} + var stu3, stu4 StuInt = Stu{"Tom"}, Stu{"Tom"} + fmt.Println(stu1 == stu2) // false + fmt.Println(stu3 == stu4) // true } +``` + +`stu1` 和 `stu2` 对应的类型是 `*Stu`，值是 Stu 结构体的地址，两个地址不同，因此结果为 false。 +`stu3` 和 `stu4` 对应的类型是 `Stu`，值是 Stu 结构体，且各字段相等，因此结果为 true。 + +### 04 2 个 nil 可能不相等吗？ + +可能不等。interface在运行时绑定值，只有值为nil接口值才为nil，但是与指针的nil不相等。举个例子： + +```go +var p *int = nil +var i interface{} = nil +if(p == i){ + fmt.Println("Equal") +} +``` + +两者并不相同。总结：**两个nil只有在类型相同时才相等**。 + +### 05 ❤简述 Go 语言GC(垃圾回收)的工作原理 + +垃圾回收机制是Go一大特(nan)色(dian)。Go1.3采用**标记清除法**， Go1.5采用**三色标记法**，Go1.8采用**三色标记法+混合写屏障**。 + +**_标记清除法_** + +分为两个阶段：标记和清除 + +标记阶段：从根对象出发寻找并标记所有存活的对象。 + +清除阶段：遍历堆中的对象，回收未标记的对象，并加入空闲链表。 + +缺点是需要暂停程序STW。 + +**_三色标记法_**： + +将对象标记为白色，灰色或黑色。 + +白色：不确定对象（默认色）；黑色：存活对象。灰色：存活对象，子对象待处理。 + +标记开始时，先将所有对象加入白色集合（需要STW）。首先将根对象标记为灰色，然后将一个对象从灰色集合取出，遍历其子对象，放入灰色集合。同时将取出的对象放入黑色集合，直到灰色集合为空。最后的白色集合对象就是需要清理的对象。 + +这种方法有一个缺陷，如果对象的引用被用户修改了，那么之前的标记就无效了。因此Go采用了**写屏障技术**，当对象新增或者更新会将其着色为灰色。 + +一次完整的GC分为四个阶段： + +1. 准备标记（需要STW），开启写屏障。 +2. 开始标记 +3. 标记结束（STW），关闭写屏障 +4. 清理（并发） + +基于插入写屏障和删除写屏障在结束时需要STW来重新扫描栈，带来性能瓶颈。**混合写屏障**分为以下四步： + +1. GC开始时，将栈上的全部对象标记为黑色（不需要二次扫描，无需STW）； +2. GC期间，任何栈上创建的新对象均为黑色 +3. 被删除引用的对象标记为灰色 +4. 被添加引用的对象标记为灰色 + +总而言之就是确保黑色对象不能引用白色对象，这个改进直接使得GC时间从 2s降低到2us。 + +### 06 函数返回局部变量的指针是否安全？ + +这一点和C++不同，在Go里面返回局部变量的指针是安全的。因为Go会进行**逃逸分析**，如果发现局部变量的作用域超过该函数则会**把指针分配到堆区**，避免内存泄漏。 + +### 07 非接口的任意类型 T() 都能够调用 `*T` 的方法吗？反过来呢？ + +一个T类型的值可以调用*T类型声明的方法，当且仅当T是**可寻址的**。 + +反之：*T 可以调用T()的方法，因为指针可以解引用。 + +### 08 go slice是怎么扩容的？ + +如果当前容量小于1024，则判断所需容量是否大于原来容量2倍，如果大于，当前容量加上所需容量；否则当前容量乘2。 + +如果当前容量大于1024，则每次按照1.25倍速度递增容量，也就是每次加上cap/4。 + +### [并发编程](https://link.zhihu.com/?target=https%3A//geektutu.com/post/qa-golang-3.html) + +### 01 ❤无缓冲的 channel 和有缓冲的 channel 的区别？ + +（这个问题笔者也纠结了很久，直到看到一篇文章，阻塞与否是分别针对发送接收方而言的，才茅塞顿开） + +对于无缓冲区channel： + +发送的数据如果没有被接收方接收，那么**发送方阻塞；**如果一直接收不到发送方的数据，**接收方阻塞**； + +有缓冲的channel： + +发送方在缓冲区满的时候阻塞，接收方不阻塞；接收方在缓冲区为空的时候阻塞，发送方不阻塞。 + +可以类比生产者与消费者问题。 + +![](https://pic3.zhimg.com/80/v2-b770e5632874d40780ecfe79701324f2_1440w.jpg) +### 02 为什么有协程泄露(Goroutine Leak)？ + +协程泄漏是指协程创建之后没有得到释放。主要原因有： + +1. 缺少接收器，导致发送阻塞 +2. 缺少发送器，导致接收阻塞 +3. 死锁。多个协程由于竞争资源导致死锁。 +4. WaitGroup Add()和Done()不相等，前者更大。 + +### 03 Go 可以限制运行时操作系统线程的数量吗？ 常见的goroutine操作函数有哪些？ + +可以，使用runtime.GOMAXPROCS(num int)可以设置线程数目。该值默认为CPU逻辑核数，如果设的太大，会引起频繁的线程切换，降低性能。 + +runtime.Gosched()，用于让出CPU时间片，让出当前goroutine的执行权限，调度器安排其它等待的任务运行，并在下次某个时候从该位置恢复执行。 +runtime.Goexit()，调用此函数会立即使当前的goroutine的运行终止（终止协程），而其它的goroutine并不会受此影响。runtime.Goexit在终止当前goroutine前会先执行此goroutine的还未执行的defer语句。请注意千万别在主函数调用runtime.Goexit，因为会引发panic。 + +### 04 如何控制协程数目。 + +> The GOMAXPROCS variable limits the number of operating system threads that can execute user-level Go code simultaneously. There is no limit to the number of threads that can be blocked in system calls on behalf of Go code; those do not count against the GOMAXPROCS limit. + +可以使用环境变量 `GOMAXPROCS` 或 `runtime.GOMAXPROCS(num int)` 设置，例如： + +```go +runtime.GOMAXPROCS(1) // 限制同时执行Go代码的操作系统线程数为 1 +``` + +从官方文档的解释可以看到，`GOMAXPROCS` 限制的是同时执行用户态 Go 代码的操作系统线程的数量，但是对于被系统调用阻塞的线程数量是没有限制的。`GOMAXPROCS` 的默认值等于 CPU 的逻辑核数，同一时间，一个核只能绑定一个线程，然后运行被调度的协程。因此对于 CPU 密集型的任务，若该值过大，例如设置为 CPU 逻辑核数的 2 倍，会增加线程切换的开销，降低性能。对于 I/O 密集型应用，适当地调大该值，可以提高 I/O 吞吐率。 + +另外对于协程，可以用带缓冲区的channel来控制，下面的例子是协程数为1024的例子 + +```go +var wg sync.WaitGroup +ch := make(chan struct{}, 1024) +for i:=0; i<20000; i++{ + wg.Add(1) + ch<-struct{}{} + go func(){ + defer wg.Done() + <-ch + } +} +wg.Wait() +``` + +此外还可以用**协程池**：其原理无外乎是将上述代码中通道和协程函数解耦，并封装成单独的结构体。常见第三方协程池库，比如[tunny](https://link.zhihu.com/?target=http%3A//github.com/Jeffail/tunny)等。 + +面试题评价：★★★☆☆。偏容易和基础。❤表示需要重点关注。 + +* * * + +## **面试题2** + +来源：Durant Thorvalds + +### ❤new和make的区别？ + +* new只用于分配内存，返回一个指向地址的**指针**。它为每个新类型分配一片内存，初始化为0且返回类型*T的内存地址，它相当于&T{} +* make只可用于**slice,map,channel**的初始化,返回的是**引用**。 + +```go +a := new(int) +*a = 46 +fmt.Println(*a) +``` + +### 请你讲一下Go面向对象是如何实现的？ + +Go实现面向对象的两个关键是struct和interface。 + +封装：对于同一个包，对象对包内的文件可见；对不同的包，需要将对象以大写开头才是可见的。 + +继承：继承是编译时特征，在struct内加入所需要继承的类即可： + +```go +type A struct{} +type B struct{ +A +} +``` + +多态：多态是运行时特征，Go多态通过interface来实现。类型和接口是松耦合的，某个类型的实例可以赋给它所实现的任意接口类型的变量。 + +Go支持多重继承，就是在类型中嵌入所有必要的父类型。 + +### 二维切片如何初始化 + +一种方式是对每一个维度都初始化。 + +另一种方式是用一个单独的一维切片初始化。 + +```go +// Allocate the top-level slice. +picture := make([][]uint8, YSize) // One row per unit of y. +// Loop over the rows, allocating the slice for each row. +for i := range picture { + picture[i] = make([]uint8, XSize) +} +// Allocate the top-level slice, the same as before. +picture := make([][]uint8, YSize) // One row per unit of y. +// Allocate one large slice to hold all the pixels. +pixels := make([]uint8, XSize*YSize) // Has type []uint8 even though picture is [][]uint8. +// Loop over the rows, slicingog each row from the front of the remaining pixels slice. +for i := range picture { + picture[i], pixels = pixels[:XSize], pixels[XSize:] +``` + +### uint型变量值分别为 1，2，它们相减的结果是多少？ + + ```go +var a uint = 1 + var b uint = 2 + fmt.Println(a - b) +``` + +答案，结果会溢出，如果是32位系统，结果是2^32-1，如果是64位系统，结果2^64-1. + +### 讲一下go有没有函数在main之前执行？怎么用？ + +go的init函数在main函数之前执行，它有如下特点： + +* 初始化不能采用初始化表达式初始化的变量； +* 程序运行前执行注册 +* 实现sync.Once功能 +* 不能被其它函数调用 +* init函数没有入口参数和返回值： + +```go +func init(){ + register... +} +``` + +* 每个包可以有多个init函数，**每个源文件也可以有多个init函数**。 +* 同一个包的init执行顺序，golang没有明确定义，编程时要注意程序不要依赖这个执行顺序。 +* 不同包的init函数按照包导入的依赖关系决定执行顺序。 + +### 下面这句代码是什么作用，为什么要定义一个空值？ + +```go +var _ Codec = (*GobCodec)(nil) +type GobCodec struct{ + conn io.ReadWriteCloser + buf *bufio.Writer + dec *gob.Decoder + enc *gob.Encoder +} + +type Codec interface { + io.Closer + ReadHeader(*Header) error + ReadBody(interface{}) error + Write(*Header, interface{}) error +} +``` + +答：将nil转换为*GobCodec类型，然后再转换为Codec接口，如果转换失败，说明*GobCodec没有实现Codec接口的所有方法。 + +### ❤golang的内存管理的原理清楚吗？简述go内存管理机制。 + +golang内存管理基本是参考tcmalloc来进行的。go内存管理本质上是一个内存池，只不过内部做了很多优化：自动伸缩内存池大小，合理的切割内存块。 + +> 一些基本概念： +> 页Page：一块8K大小的内存空间。Go向操作系统申请和释放内存都是以页为单位的。 +> span : 内存块，一个或多个连续的 page 组成一个 span 。如果把 page 比喻成工人， span 可看成是小队，工人被分成若干个队伍，不同的队伍干不同的活。 +> sizeclass : 空间规格，每个 span 都带有一个 sizeclass ，标记着该 span 中的 page 应该如何使用。使用上面的比喻，就是 sizeclass 标志着 span 是一个什么样的队伍。 +> object : 对象，用来存储一个变量数据内存空间，一个 span 在初始化时，会被切割成一堆等大的 object 。假设 object 的大小是 16B ， span 大小是 8K ，那么就会把 span 中的 page 就会被初始化 8K / 16B = 512 个 object 。所谓内存分配，就是分配一个 object 出去。 + +1. **mheap** + +一开始go从操作系统索取一大块内存作为内存池，并放在一个叫mheap的内存池进行管理，mheap将一整块内存切割为不同的区域，并将一部分内存切割为合适的大小。 + +![](https://pic3.zhimg.com/80/v2-05f622a5c88a9a9456d43ee301622582_1440w.jpg) + +mheap.spans ：用来存储 page 和 span 信息，比如一个 span 的起始地址是多少，有几个 page，已使用了多大等等。 + +mheap.bitmap 存储着各个 span 中对象的标记信息，比如对象是否可回收等等。 + +mheap.arena_start : 将要分配给应用程序使用的空间。 + +1. **mcentral** + +用途相同的span会以链表的形式组织在一起存放在mcentral中。这里用途用**sizeclass**来表示，就是该span存储哪种大小的对象。 + +找到合适的 span 后，会从中取一个 object 返回给上层使用。 + +1. **mcache** + +为了提高内存并发申请效率，加入缓存层mcache。每一个mcache和处理器P对应。Go申请内存首先从P的mcache中分配，如果没有可用的span再从mcentral中获取。 + +> 参考资料：[Go 语言内存管理（二）：Go 内存管理](https://link.zhihu.com/?target=https%3A//cloud.tencent.com/developer/article/1422392) + +### ❤mutex有几种模式？ + +mutex有两种模式：**normal** 和 **starvation** + +正常模式 + +所有goroutine按照FIFO的顺序进行锁获取，被唤醒的goroutine和新请求锁的goroutine同时进行锁获取，通常**新请求锁的goroutine更容易获取锁**(持续占有cpu)，被唤醒的goroutine则不容易获取到锁。公平性：否。 + +饥饿模式 + +所有尝试获取锁的goroutine进行等待排队，**新请求锁的goroutine不会进行锁获取**(禁用自旋)，而是加入队列尾部等待获取锁。公平性：是。 + +> 参考链接：[Go Mutex 饥饿模式](https://link.zhihu.com/?target=https%3A//blog.csdn.net/qq_37102984/article/details/115322706)，[GO 互斥锁（Mutex）原理](https://link.zhihu.com/?target=https%3A//blog.csdn.net/baolingye/article/details/111357407%23%3A~%3Atext%3D%25E6%25AF%258F%25E4%25B8%25AAMutex%25E9%2583%25BD%2Ctarving%25E3%2580%2582) + +* * * + +## **面试题3** + +来源**：**[如果你是一个Golang面试官，你会问哪些问题？](https://www.zhihu.com/question/67846139/answer/1983588716) + +### ❤go如何进行调度的。GMP中状态流转。 + +Go里面GMP分别代表：G：goroutine，M：线程（真正在CPU上跑的），P：调度器。 + +![](https://pic3.zhimg.com/80/v2-63a317972091b6d43863c5144a6badce_1440w.jpg)GMP模型 + +调度器是M和G之间桥梁。 + +go进行调度过程： + +* 某个线程尝试创建一个新的G，那么这个G就会被安排到这个线程的G本地队列LRQ中，如果LRQ满了，就会分配到全局队列GRQ中； +* 尝试获取当前线程的M，如果无法获取，就会从空闲的M列表中找一个，如果空闲列表也没有，那么就创建一个M，然后绑定G与P运行。 +* 进入调度循环： + +* 找到一个合适的G +* 执行G，完成以后退出 + +### Go什么时候发生阻塞？阻塞时，调度器会怎么做。 + +* 用于**原子、互斥量或通道**操作导致goroutine阻塞，调度器将把当前阻塞的goroutine从本地运行队列**LRQ换出**，并重新调度其它goroutine； +* 由于**网络请求**和**IO**导致的阻塞，Go提供了网络轮询器（Netpoller）来处理，后台用epoll等技术实现IO多路复用。 + +其它回答： + +* **channel阻塞**：当goroutine读写channel发生阻塞时，会调用gopark函数，该G脱离当前的M和P，调度器将新的G放入当前M。 +* **系统调用**：当某个G由于系统调用陷入内核态，该P就会脱离当前M，此时P会更新自己的状态为Psyscall，M与G相互绑定，进行系统调用。结束以后，若该P状态还是Psyscall，则直接关联该M和G，否则使用闲置的处理器处理该G。 +* **系统监控**：当某个G在P上运行的时间超过10ms时候，或者P处于Psyscall状态过长等情况就会调用retake函数，触发新的调度。 +* **主动让出**：由于是协作式调度，该G会主动让出当前的P（通过GoSched），更新状态为Grunnable，该P会调度队列中的G运行。 + +> 更多关于netpoller的内容可以参看：[https://strikefreedom.top/go-netpoll-io-multiplexing-reactor](https://link.zhihu.com/?target=https%3A//strikefreedom.top/go-netpoll-io-multiplexing-reactor) + +### ❤Go中GMP有哪些状态？ + +G的状态： + +**_Gidle**：刚刚被分配并且还没有被初始化，值为0，为创建goroutine后的默认值 + +**_Grunnable**： 没有执行代码，没有栈的所有权，存储在运行队列中，可能在某个P的本地队列或全局队列中(如上图)。 + +**_Grunning**： 正在执行代码的goroutine，拥有栈的所有权(如上图)。 + +**_Gsyscall**：正在执行系统调用，拥有栈的所有权，与P脱离，但是与某个M绑定，会在调用结束后被分配到运行队列(如上图)。 + +**_Gwaiting**：被阻塞的goroutine，阻塞在某个channel的发送或者接收队列(如上图)。 + +**_Gdead**： 当前goroutine未被使用，没有执行代码，可能有分配的栈，分布在空闲列表gFree，可能是一个刚刚初始化的goroutine，也可能是执行了goexit退出的goroutine(如上图)。 + +**_Gcopystac**：栈正在被拷贝，没有执行代码，不在运行队列上，执行权在 + +**_Gscan** ： GC 正在扫描栈空间，没有执行代码，可以与其他状态同时存在。 + +P的状态： + +**_Pidle** ：处理器没有运行用户代码或者调度器，被空闲队列或者改变其状态的结构持有，运行队列为空 + +**_Prunning** ：被线程 M 持有，并且正在执行用户代码或者调度器(如上图) + +**_Psyscall**：没有执行用户代码，当前线程陷入系统调用(如上图) + +**_Pgcstop** ：被线程 M 持有，当前处理器由于垃圾回收被停止 + +**_Pdead** ：当前处理器已经不被使用 + +M的状态： + +**自旋线程**：处于运行状态但是没有可执行goroutine的线程，数量最多为GOMAXPROC，若是数量大于GOMAXPROC就会进入休眠。 + +**非自旋线程**：处于运行状态有可执行goroutine的线程。 + +下面一张图很好的展示了Goroutine状态流转： + +![](https://pic4.zhimg.com/80/v2-3312a9b7852f67257a1266bd56e2aa1f_1440w.jpg)Goroutine状态流转 +### GMP能不能去掉P层？会怎么样？ + +去掉p会导致，当G进行**系统调用时候，会一直阻塞**，其它G无法获得M。 + +### 如果有一个G一直占用资源怎么办。 + +如果有个goroutine一直占用资源，那么GMP模型会**从正常模式转变为饥饿模式**（类似于mutex），允许其它goroutine抢占（禁用自旋锁）。 + +### 若干线程一个线程发生OOM(Out of memory)会怎么办。 + +对于线程而言：发生内存溢出的线程会被kill，其它线程不受影响。 + +### goroutine什么情况会发生内存泄漏？如何避免。 + +在Go中内存泄露分为暂时性内存泄露和永久性内存泄露。 + +**暂时性内存泄露** + +* 获取长字符串中的一段导致长字符串未释放 +* 获取长slice中的一段导致长slice未释放 +* 在长slice新建slice导致泄漏 + +string相比切片少了一个容量的cap字段，可以把string当成一个只读的切片类型。获取长string或者切片中的一段内容，由于新生成的对象和老的string或者切片共用一个内存空间，会导致老的string和切片资源暂时得不到释放，造成短暂的内存泄漏 + +**永久性内存泄露** + +* goroutine永久阻塞而导致泄漏 +* time.Ticker未关闭导致泄漏 +* 不正确使用Finalizer导致泄漏 + +### 怎么调试go？ + +在vscode设置mode为debug。需要go-dlv插件。 + +### Go GC有几个阶段 + +目前的go GC采用**三色标记法**和**混合写屏障**技术。 + +Go GC有**四**个阶段: + +* STW，开启混合写屏障，扫描栈对象； +* 将所有对象加入白色集合，从根对象开始，将其放入灰色集合。每次从灰色集合取出一个对象标记为黑色，然后遍历其子对象，标记为灰色，放入灰色集合； +* 如此循环直到灰色集合为空。剩余的白色对象就是需要清理的对象。 +* STW，关闭混合写屏障； +* 在后台进行GC（并发）。 + +### go竞态条件了解吗？ + +所谓竞态竞争，就是当**两个或以上的goroutine访问相同资源时候，对资源进行读/写。** + +比如`var a int = 0`，有两个协程分别对a+=1，我们发现最后a不一定为2.这就是竞态竞争。 + +通常我们可以用`go run -race xx.go`来进行检测。 + +解决方法是，对临界区资源上锁，或者使用原子操作(atomics)，原子操作的开销小于上锁。 + +### 如果若干个goroutine，有一个panic会怎么做？ + +有一个panic，那么剩余goroutine也会退出。 + +> 参考理解：[goroutine配上panic会怎样](https://link.zhihu.com/?target=https%3A//blog.csdn.net/huorongbj/article/details/123013273)。 + +### defer可以捕获goroutine的子goroutine吗？ + +不可以。它们处于不同的调度器P中。对于子goroutine，正确的做法是： + +1. 必须通过 defer 关键字来调用 recover()。 +2. 当通过 goroutine 调用某个方法，一定要确保内部有 recover() 机制。 + +### ❤gRPC是什么？ + +基于go的**远程过程调用**。RPC 框架的目标就是让远程服务调用更加简单、透明，RPC 框架负责屏蔽底层的传输方式（TCP 或者 UDP）、序列化方式（XML/Json/ 二进制）和通信细节。服务调用者可以像调用本地接口一样调用远程的服务提供者，而不需要关心底层通信细节和调用过程。 + +![](https://pic3.zhimg.com/80/v2-53fcdf2682c027f2d16292c4b4ba20d6_1440w.jpg)gRPC框架图 +## 面试题4 + +需要面试者有一定的大型项目经验经验，了解使用**微服务，etcd，gin，gorm，gRPC**等典型框架等模型或框架。 + +### 微服务了解吗？ + +微服务是一种开发软件的架构和组织方法，其中软件由通过明确定义的 API 进行通信的小型独立服务组成。微服务架构使应用程序更易于扩展和更快地开发，从而加速创新并缩短新功能的上市时间。 + +![](https://pic3.zhimg.com/80/v2-56601175dc48fbec496c79284488ecee_1440w.jpg)微服务示意图 + +微服务有着自主，专用，灵活性等优点。 + +> 参考资料：[什么是微服务？| AWS](https://link.zhihu.com/?target=https%3A//aws.amazon.com/cn/microservices/) + +### 服务发现是怎么做的？ + +主要有两种服务发现机制：**客户端发现**和**服务端发现**。 + +**客户端发现模式**：当我们使用客户端发现的时候，客户端负责决定可用服务实例的网络地址并且在集群中对请求负载均衡, 客户端访问**服务登记表**，也就是一个可用服务的数据库，然后客户端使用一种**负载均衡算法**选择一个可用的服务实例然后发起请求。该模式如下图所示： + +![](https://pic2.zhimg.com/80/v2-915e057bb7b6783393cdf1bfd2d0d745_1440w.jpg)客户端发现模式 + +**服务端发现模式**：客户端通过**负载均衡器**向某个服务提出请求，负载均衡器查询服务注册表，并将请求转发到可用的服务实例。如同客户端发现，服务实例在服务注册表中注册或注销。 + +![](https://pic3.zhimg.com/80/v2-fe7926e3a7007f985a87e102743a842e_1440w.jpg)服务端发现模式 + +参考资料：[「Chris Richardson 微服务系列」服务发现的可行方案以及实践案例](https://link.zhihu.com/?target=http%3A//blog.daocloud.io/3289.html) + +### ETCD用过吗？ + +**etcd**是一个**高度一致**的**分布式键值存储**，它提供了一种可靠的方式来存储需要由分布式系统或机器集群访问的数据。它可以优雅地处理网络分区期间的领导者**选举**，即使在领导者节点中也可以容忍机器故障。 + +etcd 是用**Go语言**编写的，它具有出色的跨平台支持，小的二进制文件和强大的社区。etcd机器之间的通信通过**Raft共识算法**处理。 + +关于文档可以参考：[v3.5 docs](https://link.zhihu.com/?target=https%3A//etcd.io/docs/v3.5/) + +### GIN怎么做参数校验？ + +go采用validator作参数校验。 + +它具有以下独特功能： + +* 使用验证tag或自定义validator进行跨字段Field和跨结构体验证。 +* 允许切片、数组和哈希表，多维字段的任何或所有级别进行校验。 +* 能够对哈希表key和value进行验证 +* 通过在验证之前确定它的基础类型来处理类型接口。 +* 别名验证标签，允许将多个验证映射到单个标签，以便更轻松地定义结构体上的验证 +* gin web 框架的默认验证器； + +参考资料：[validator package - pkg.go.dev](https://link.zhihu.com/?target=https%3A//pkg.go.dev/github.com/go-playground/validator%23section-readme) + +### 中间件用过吗？ + +Middleware是Web的重要组成部分，中间件（通常）是一小段代码，它们接受一个请求，对其进行处理，每个中间件只处理一件事情，完成后将其传递给另一个中间件或最终处理程序，这样就做到了程序的解耦。 + +### Go解析Tag是怎么实现的？ + +Go解析tag采用的是**反射**。 + +具体来说使用reflect.ValueOf方法获取其反射值，然后获取其Type属性，之后再通过Field(i)获取第i+1个field，再.Tag获得Tag。 + +反射实现的原理在: `src/reflect/type.go`中 + +### 你项目有优雅的启停吗？ + +所谓「优雅」启停就是在启动退出服务时要满足以下几个条件： + +* **不可以关闭现有连接**（进程） +* 新的进程启动并「**接管**」旧进程 +* 连接要**随时响应用户请求**，不可以出现拒绝请求的情况 +* 停止的时候，必须**处理完既有连接**，并且**停止接收新的连接**。 + +为此我们必须引用**信号**来完成这些目的： + +启动： + +* 监听SIGHUP（在用户终端连接(正常或非正常)结束时发出）； +* 收到信号后将服务监听的文件描述符传递给新的子进程，此时新老进程同时接收请求； + +退出： + +* 监听SIGINT和SIGSTP和SIGQUIT等。 +* 父进程停止接收新请求，等待旧请求完成（或超时）； +* 父进程退出。 + +实现：go1.8采用Http.Server内置的Shutdown方法支持优雅关机。 然后[fvbock/endless](https://link.zhihu.com/?target=http%3A//github.com/fvbock/endless)可以实现优雅重启。 + +> 参考资料：[gin框架实践连载八 | 如何优雅重启和停止 - 掘金](https://link.zhihu.com/?target=https%3A//juejin.cn/post/6867074626427502600%23heading-3)，[优雅地关闭或重启 go web 项目](https://link.zhihu.com/?target=http%3A//www.phpxs.com/post/7186/) + +### 持久化怎么做的？ + +所谓持久化就是将要保存的字符串写到硬盘等设备。 + +* 最简单的方式就是采用ioutil的WriteFile()方法将字符串写到磁盘上，这种方法面临**格式化**方面的问题。 +* 更好的做法是将数据按照**固定协议**进行组织再进行读写，比如JSON，XML，Gob，csv等。 +* 如果要考虑**高并发**和**高可用**，必须把数据放入到数据库中，比如MySQL，PostgreDB，MongoDB等。 + +参考链接：[Golang 持久化](https://link.zhihu.com/?target=https%3A//www.jianshu.com/p/015aca3e11ae) + +* * * + +## **面试题5** + +作者：Dylan2333 链接： + + [测开转Go开发-面经&总结_笔经面经_牛客网​www.nowcoder.com/discuss/826193?type=post&order=recall&pos=&page=1&ncTraceId=&channel=-1&source_id=search_post_nctrack&gio_id=9C5DC1FFB3FC3BE29281D7CCFC420365-1645173894793![](https://pic1.zhimg.com/v2-ed411b6288d53218e5e9dd056d1df020_ipico.jpg)](https://link.zhihu.com/?target=https%3A//www.nowcoder.com/discuss/826193%3Ftype%3Dpost%26order%3Drecall%26pos%3D%26page%3D1%26ncTraceId%3D%26channel%3D-1%26source_id%3Dsearch_post_nctrack%26gio_id%3D9C5DC1FFB3FC3BE29281D7CCFC420365-1645173894793) + +该试题需要面试者有非常丰富的项目阅历和底层原理经验，熟练使用**微服务，etcd，gin，gorm，gRPC**等典型框架等模型或框架。 + +### channel 死锁的场景 + +* 当一个`channel`中没有数据，而直接读取时，会发生死锁： + +```go +q := make(chan int,2) +<-q +``` + +解决方案是采用select语句，再default放默认处理方式： + +```go +q := make(chan int,2) +select{ + case val:=<-q: + default: + ... + +} +``` + +* 当channel数据满了，再尝试写数据会造成死锁： + +```go +q := make(chan int,2) +q<-1 +q<-2 +q<-3 +``` + +解决方法，采用select + +```go +func main() { + q := make(chan int, 2) + q <- 1 + q <- 2 + select { + case q <- 3: + fmt.Println("ok") + default: + fmt.Println("wrong") + } + +} +``` + +* 向一个关闭的channel写数据。 + +注意：一个已经关闭的channel，只能读数据，不能写数据。 + +参考资料：[Golang关于channel死锁情况的汇总以及解决方案](https://link.zhihu.com/?target=https%3A//blog.csdn.net/qq_35976351/article/details/81984117) + +### 读写channel应该先关哪个？ + +应该写channel先关。因为对于已经关闭的channel只能读，不能写。 + +### 对已经关闭的chan进行读写会怎么样？ + +* 读已经关闭的chan能一直读到东西，但是读到的内容根据通道内关闭前是否有元素而不同。 + +* 如果chan关闭前，buffer内有元素还未读,会正确读到chan内的值，且返回的第二个bool值（是否读成功）为true。 +* 如果chan关闭前，buffer内有元素已经被读完，chan内无值，接下来所有接收的值都会非阻塞直接成功，返回 channel 元素的零值，但是第二个bool值一直为false。 + +写已经关闭的chan会panic。 + +### 说说 atomic底层怎么实现的. + +atomic源码位于`sync\atomic`。通过阅读源码可知，atomic采用**CAS**（CompareAndSwap）的方式实现的。所谓CAS就是使用了CPU中的原子性操作。在操作共享变量的时候，CAS不需要对其进行加锁，而是通过类似于乐观锁的方式进行检测，总是假设被操作的值未曾改变（即与旧值相等），并一旦确认这个假设的真实性就立即进行值替换。本质上是**不断占用CPU资源来避免加锁的开销**。 + +> 参考资料：[Go语言的原子操作atomic - 编程猎人](https://link.zhihu.com/?target=https%3A//www.programminghunter.com/article/37392193442/) + +### channel底层实现？是否线程安全。 + +channel底层实现在`src/runtime/chan.go`中 + +channel内部是一个循环链表。内部包含buf, sendx, recvx, lock ,recvq, sendq几个部分； + +buf是有缓冲的channel所特有的结构，用来存储缓存数据。是个循环链表； + +* sendx和recvx用于记录buf这个循环链表中的发送或者接收的index； +* lock是个互斥锁； +* recvq和sendq分别是接收(<-channel)或者发送(channel <- xxx)的goroutine抽象出来的结构体(sudog)的队列。是个双向链表。 + +channel是**线程安全**的。 + +> 参考资料：[Kitou：Golang 深度剖析 -- channel的底层实现](https://zhuanlan.zhihu.com/p/264305133) + +### map的底层实现。 + +源码位于`src\runtime\map.go` 中。 + +go的map和C++map不一样，底层实现是哈希表，包括两个部分：**hmap**和**bucket**。 + +hmap结构体如图： + +```go +type hmap struct { + count int //map元素的个数，调用len()直接返回此值 + + // map标记: + // 1\. key和value是否包指针 + // 2\. 是否正在扩容 + // 3\. 是否是同样大小的扩容 + // 4\. 是否正在 `range`方式访问当前的buckets + // 5\. 是否有 `range`方式访问旧的bucket + flags uint8 + + B uint8 // buckets 的对数 log_2, buckets 数组的长度就是 2^B + noverflow uint16 // overflow 的 bucket 近似数 + hash0 uint32 // hash种子 计算 key 的哈希的时候会传入哈希函数 + buckets unsafe.Pointer // 指向 buckets 数组，大小为 2^B 如果元素个数为0，就为 nil + + // 扩容的时候，buckets 长度会是 oldbuckets 的两倍 + oldbuckets unsafe.Pointer // bucket slice指针，仅当在扩容的时候不为nil + + nevacuate uintptr // 扩容时已经移到新的map中的bucket数量 + extra *mapextra // optional fields +} +``` + +里面最重要的是buckets（桶）。buckets是一个指针，最终它指向的是一个结构体： + +```go +// A bucket for a Go map. +type bmap struct { + tophash [bucketCnt]uint8 +} +``` + +每个bucket固定包含8个key和value(可以查看源码bucketCnt=8).实现上面是一个固定的大小连续内存块，分成四部分：每个条目的状态，8个key值，8个value值，指向下个bucket的指针。 + +创建哈希表使用的是`makemap`函数.map 的一个关键点在于，**哈希函数**的选择。在程序启动时，会检测 cpu 是否支持 aes，如果支持，则使用 aes hash，否则使用 memhash。这是在函数 alginit() 中完成，位于路径：`src/runtime/alg.go` 下。 + +map查找就是将key哈希后得到64位（64位机）用最后B个比特位计算在哪个桶。在 bucket 中，从前往后找到第一个空位。这样，在查找某个 key 时，先找到对应的桶，再去遍历 bucket 中的 key。 + +关于map的查找和扩容可以参考[map的用法到map底层实现分析](https://link.zhihu.com/?target=https%3A//blog.csdn.net/chenxun_2010/article/details/103768011%3Futm_medium%3Ddistribute.pc_relevant.none-task-blog-2~default~baidujs_baidulandingword~default-0.pc_relevant_aa%26spm%3D1001.2101.3001.4242.1%26utm_relevant_index%3D3)。 + +### select的实现原理？ + +select源码位于`src\runtime\select.go`，最重要的`scase` 数据结构为： + +```go +type scase struct { + c *hchan // chan + elem unsafe.Pointer // data element +} +``` + +scase.c为当前case语句所操作的channel指针，这也说明了一个case语句只能操作一个channel。 + +scase.elem表示缓冲区地址： + +* caseRecv ： scase.elem表示读出channel的数据存放地址； +* caseSend ： scase.elem表示将要写入channel的数据存放地址； + +select的主要实现位于：`selectgo`函数：其主要功能如下： + +```go +//1\. 锁定scase语句中所有的channel + //2\. 按照随机顺序检测scase中的channel是否ready + // 2.1 如果case可读，则读取channel中数据，解锁所有的channel，然后返回(case index, true) + // 2.2 如果case可写，则将数据写入channel，解锁所有的channel，然后返回(case index, false) + // 2.3 所有case都未ready，则解锁所有的channel，然后返回（default index, false） + //3\. 所有case都未ready，且没有default语句 + // 3.1 将当前协程加入到所有channel的等待队列 + // 3.2 当将协程转入阻塞，等待被唤醒 + //4\. 唤醒后返回channel对应的case index + // 4.1 如果是读操作，解锁所有的channel，然后返回(case index, true) + // 4.2 如果是写操作，解锁所有的channel，然后返回(case index, false) +``` + +参考资料：[Go select的使用和实现原理](https://link.zhihu.com/?target=https%3A//www.cnblogs.com/wuyepeng/p/13910678.html%23%3A~%3Atext%3D%25E4%25B8%2580%25E3%2580%2581select%25E7%25AE%2580%25E4%25BB%258B.%25201.Go%25E7%259A%2584select%25E8%25AF%25AD%25E5%258F%25A5%25E6%2598%25AF%25E4%25B8%2580%25E7%25A7%258D%25E4%25BB%2585%25E8%2583%25BD%25E7%2594%25A8%25E4%25BA%258Echannl%25E5%258F%2591%25E9%2580%2581%25E5%2592%258C%25E6%258E%25A5%25E6%2594%25B6%25E6%25B6%2588%25E6%2581%25AF%25E7%259A%2584%25E4%25B8%2593%25E7%2594%25A8%25E8%25AF%25AD%25E5%258F%25A5%25EF%25BC%258C%25E6%25AD%25A4%25E8%25AF%25AD%25E5%258F%25A5%25E8%25BF%2590%25E8%25A1%258C%25E6%259C%259F%25E9%2597%25B4%25E6%2598%25AF%25E9%2598%25BB%25E5%25A1%259E%25E7%259A%2584%25EF%25BC%259B%25E5%25BD%2593select%25E4%25B8%25AD%25E6%25B2%25A1%25E6%259C%2589case%25E8%25AF%25AD%25E5%258F%25A5%25E7%259A%2584%25E6%2597%25B6%25E5%2580%2599%25EF%25BC%258C%25E4%25BC%259A%25E9%2598%25BB%25E5%25A1%259E%25E5%25BD%2593%25E5%2589%258Dgroutine%25E3%2580%2582.%25202.select%25E6%2598%25AFGolang%25E5%259C%25A8%25E8%25AF%25AD%25E8%25A8%2580%25E5%25B1%2582%25E9%259D%25A2%25E6%258F%2590%25E4%25BE%259B%25E7%259A%2584I%252FO%25E5%25A4%259A%25E8%25B7%25AF%25E5%25A4%258D%25E7%2594%25A8%25E7%259A%2584%25E6%259C%25BA%25E5%2588%25B6%25EF%25BC%258C%25E5%2585%25B6%25E4%25B8%2593%25E9%2597%25A8%25E7%2594%25A8%25E6%259D%25A5%25E6%25A3%2580%25E6%25B5%258B%25E5%25A4%259A%25E4%25B8%25AAchannel%25E6%2598%25AF%25E5%2590%25A6%25E5%2587%2586%25E5%25A4%2587%25E5%25AE%258C%25E6%25AF%2595%25EF%25BC%259A%25E5%258F%25AF%25E8%25AF%25BB%25E6%2588%2596%25E5%258F%25AF%25E5%2586%2599%25E3%2580%2582.%2C3.select%25E8%25AF%25AD%25E5%258F%25A5%25E4%25B8%25AD%25E9%2599%25A4default%25E5%25A4%2596%25EF%25BC%258C%25E6%25AF%258F%25E4%25B8%25AAcase%25E6%2593%258D%25E4%25BD%259C%25E4%25B8%2580%25E4%25B8%25AAchannel%25EF%25BC%258C%25E8%25A6%2581%25E4%25B9%2588%25E8%25AF%25BB%25E8%25A6%2581%25E4%25B9%2588%25E5%2586%2599.%25204.select%25E8%25AF%25AD%25E5%258F%25A5%25E4%25B8%25AD%25E9%2599%25A4default%25E5%25A4%2596%25EF%25BC%258C%25E5%2590%2584case%25E6%2589%25A7%25E8%25A1%258C%25E9%25A1%25BA%25E5%25BA%258F%25E6%2598%25AF%25E9%259A%258F%25E6%259C%25BA%25E7%259A%2584.%25205.select%25E8%25AF%25AD%25E5%258F%25A5%25E4%25B8%25AD%25E5%25A6%2582%25E6%259E%259C%25E6%25B2%25A1%25E6%259C%2589default%25E8%25AF%25AD%25E5%258F%25A5%25EF%25BC%258C%25E5%2588%2599%25E4%25BC%259A%25E9%2598%25BB%25E5%25A1%259E%25E7%25AD%2589%25E5%25BE%2585%25E4%25BB%25BB%25E4%25B8%2580case.%25206.select%25E8%25AF%25AD%25E5%258F%25A5%25E4%25B8%25AD%25E8%25AF%25BB%25E6%2593%258D%25E4%25BD%259C%25E8%25A6%2581%25E5%2588%25A4%25E6%2596%25AD%25E6%2598%25AF%25E5%2590%25A6%25E6%2588%2590%25E5%258A%259F%25E8%25AF%25BB%25E5%258F%2596%25EF%25BC%258C%25E5%2585%25B3%25E9%2597%25AD%25E7%259A%2584channel%25E4%25B9%259F%25E5%258F%25AF%25E4%25BB%25A5%25E8%25AF%25BB%25E5%258F%2596). + +### go的interface怎么实现的？ + +go interface源码在`runtime\iface.go`中。 + +go的接口由两种类型实现`iface`和`eface`。iface是包含方法的接口，而eface不包含方法。 + +* `iface` + +对应的数据结构是（位于`src\runtime\runtime2.go`）： + +```go +type iface struct { + tab *itab + data unsafe.Pointer +} +``` + +可以简单理解为，tab表示接口的具体结构类型，而data是接口的值。 + +itab： + +```go +type itab struct { + inter *interfacetype //此属性用于定位到具体interface + _type *_type //此属性用于定位到具体interface + hash uint32 // copy of _type.hash. Used for type switches. + _ [4]byte + fun [1]uintptr // variable sized. fun[0]==0 means _type does not implement inter. +} +``` + +属性`interfacetype`类似于`_type`，其作用就是interface的公共描述，类似的还有`maptype`、`arraytype`、`chantype`…其都是各个结构的公共描述，可以理解为一种外在的表现信息。interfaetype和type唯一确定了接口类型，而hash用于查询和类型判断。fun表示方法集。 + +* `eface` + +与iface基本一致，但是用`_type`直接表示类型，这样的话就无法使用方法。 + +```go +type eface struct { + _type *_type + data unsafe.Pointer +} +``` + +这里篇幅有限，深入讨论可以看：[深入研究 Go interface 底层实现](https://link.zhihu.com/?target=https%3A//halfrost.com/go_interface/%23toc-1) + +### go的reflect 底层实现 + +go reflect源码位于`src\reflect\`下面，作为一个库独立存在。反射是基于**接口**实现的。 + +Go反射有三大法则： + +* 反射从**接口**映射到**反射对象；** + +![](https://pic2.zhimg.com/80/v2-350518add3d5e2757a8bc98f3c6fc15d_1440w.jpg)法则1 + +* 反射从**反射对象**映射到**接口值**； + +![](https://pic3.zhimg.com/80/v2-c2354d13a1514a482efa60e3d8cff816_1440w.jpg)法则2 + +* 只有**值可以修改**(settable)，才可以**修改**反射对象。 + +Go反射基于上述三点实现。我们先从最核心的两个源文件入手`type.go`和`value.go`. + +type用于获取当前值的类型。value用于获取当前的值。 + +> 参考资料：[The Laws of Reflection](https://link.zhihu.com/?target=https%3A//go.dev/blog/laws-of-reflection)， [图解go反射实现原理](https://link.zhihu.com/?target=https%3A//i6448038.github.io/2020/02/15/golang-reflection/) + +### go GC的原理知道吗？ + +如果需要从源码角度解释GC，推荐阅读（非常详细，图文并茂）： + +[https://draveness.me/golang/docs/part3-runtime/ch07-memory/golang-garbage-collector/](https://link.zhihu.com/?target=https%3A//draveness.me/golang/docs/part3-runtime/ch07-memory/golang-garbage-collector/) + +### go里用过哪些设计模式 。[Go 语言垃圾收集器的实现原理](https://link.zhihu.com/?target=https%3A//draveness.me/golang/docs/part3-runtime/ch07-memory/golang-garbage-collector/)go里用过哪些设计模式 。 + +工厂模式：比如New()方法返回一个对象实例。 + +单例模式：比如日志系统，只需要一个实例就可以完成日志记录了。 + +更多的可以模式可以参考：[Go语言设计模式汇总](https://link.zhihu.com/?target=https%3A//www.cnblogs.com/Survivalist/p/11207789.html) + +### go的调试/分析工具用过哪些。 + +go的自带工具链相当丰富， + +* go cover : 测试代码覆盖率； +* godoc: 用于生成go文档； +* pprof：用于性能调优，针对cpu，内存和并发； +* race：用于竞争检测； + +### 进程被kill，如何保证所有goroutine顺利退出 + +goroutine监听SIGKILL信号，一旦接收到SIGKILL，则立刻退出。可采用select方法。 + +### 说说context包的作用？你用过哪些，原理知道吗？ + +`context`可以用来在`goroutine`之间传递上下文信息，相同的`context`可以传递给运行在不同`goroutine`中的函数，上下文对于多个`goroutine`同时使用是安全的，`context`包定义了上下文类型，可以使用`background`、`TODO`创建一个上下文，在函数调用链之间传播`context`，也可以使用`WithDeadline`、`WithTimeout`、`WithCancel` 或 `WithValue` 创建的修改副本替换它，听起来有点绕，其实总结起就是一句话：`context`的作用就是在不同的`goroutine`之间同步请求特定的数据、取消信号以及处理请求的截止日期。 + +关于context原理，可以参看：[小白也能看懂的context包详解：从入门到精通](https://link.zhihu.com/?target=https%3A//cloud.tencent.com/developer/article/1900658) + +### grpc为啥好，基本原理是什么，和http比呢 + +官方介绍：gRPC 是一个现代开源的**高性能远程过程调用** (RPC) 框架，可以在**任何环境**中运行。它可以通过对负载平衡、跟踪、健康检查和身份验证的可插拔支持有效地连接数据中心内和跨数据中心的服务。它也适用于分布式计算的最后一英里，将设备、移动应用程序和浏览器连接到后端服务。 + +区别： +- rpc是远程过程调用，就是本地去调用一个远程的函数，而http是通过 url和符合restful风格的数据包去发送和获取数据； +- rpc的一般使用的编解码协议更加高效，比如grpc使用protobuf编解码。而http的一般使用json进行编解码，数据相比rpc更加直观，但是数据包也更大，效率低下； +- rpc一般用在服务内部的相互调用，而http则用于和用户交互； +相似点： +都有类似的机制，例如grpc的metadata机制和http的头机制作用相似，而且web框架，和rpc框架中都有拦截器的概念。grpc使用的是http2.0协议。 +官网：[gRPC](https://link.zhihu.com/?target=https%3A//grpc.io/) + +### etcd怎么搭建的，具体怎么用的 + +### 熔断怎么做的 + +### 服务降级怎么搞 + +### 1亿条数据动态增长，取top10，怎么实现 + +### 进程挂了怎么办 + +### nginx配置过吗，有哪些注意的点 + +### 设计一个阻塞队列 + +### mq消费阻塞怎么办 + +### 性能没达到预期，有什么解决方案 + +* * * + +## 编程系列 + +### 一个10G的文件，里面全部是自然数，一行一个，乱序排列，对其排序。在32位机器上面完成，内存限制为 2G（bitmap原理知道吗？） + +首先，10G文件是不可能一次性放到内存里的。这类问题一般有两种解决方案： + +* 将10G文件分成多个小文件，分别排序，最后合并一个文件； +* 采用bitmap + +如果面试大数据类岗位，可能面试官就想考察你对Mapreduce熟悉程度，要采用第一种merge and sort。 + +如果是算法类岗位，就要考虑bitmap，但需要注意的是bitmap**不能对重复数据进行排序**。这里我们详细介绍一下： + +定量分析一下，32位机器自然数有2^32个，用一个bit来存放一个整数，那么所需的内存是，`2^32/(8<<20) = 512MB` ，这些数存放在文件中，一行一个，需要20G容量，所以题目问10G文件，只需要256MB内存就可以完成。 + +bitmap实现具体分为两步：插入一个数，和排序。 + +```go +type BitMap struct { + vec []byte + size int +} + +func New(size int) *BitMap { + return &BitMap{ + size: size, + vec: make([]byte, size), + } +} + +func (bm *BitMap) Set(num int) (ok bool, err error) { + if num/8 >= bm.size { + return false, errors.New("the num overflows the size of bitmap") + } + bm.vec[num/8] |= 1 << (num % 8) + return true, nil +} + +func (bm *BitMap) Exist(num int) bool { + if num/8 >= bm.size { + return false + } + return bm.vec[num/8]&(1<<(num%8)) > 0 +} + +func (bm *BitMap) Sort() (ret []int) { + ret = make([]int, 0) + for i := 0; i < (8 * bm.size); i++ { + if bm.Exist(i) { + ret = append(ret, i) + } + } + return +} +``` + +### 实现使用字符串函数名，调用函数。 + +思路：采用反射的Call方法实现。 + +```go +package main +import ( + "fmt" + "reflect" +) + +type Animal struct{ + +} + +func (a *Animal) Eat(){ + fmt.Println("Eat") +} + +func main(){ + a := Animal{} + reflect.ValueOf(&a).MethodByName("Eat").Call([]reflect.Value{}) + +} +``` + +### 负载均衡算法。（一致性哈希） + +```go +package main + +import ( + "fmt" + "sort" + "strconv" +) + +type HashFunc func(key []byte) uint32 + +type ConsistentHash struct { + hash HashFunc + hashvals []int + hashToKey map[int]string + virtualNum int +} + +func NewConsistentHash(virtualNum int, fn HashFunc) *ConsistentHash { + return &ConsistentHash{ + hash: fn, + virtualNum: virtualNum, + hashToKey: make(map[int]string), + } +} + +func (ch *ConsistentHash) AddNode(keys ...string) { + for _, k := range keys { + for i := 0; i < ch.virtualNum; i++ { + conv := strconv.Itoa(i) + hashval := int(ch.hash([]byte(conv + k))) + ch.hashvals = append(ch.hashvals, hashval) + ch.hashToKey[hashval] = k + } + } + sort.Ints(ch.hashvals) +} + +func (ch *ConsistentHash) GetNode(key string) string { + if len(ch.hashToKey) == 0 { + return "" + } + keyhash := int(ch.hash([]byte(key))) + id := sort.Search(len(ch.hashToKey), func(i int) bool { + return ch.hashvals[i] >= keyhash + }) + return ch.hashToKey[ch.hashvals[id%len(ch.hashvals)]] +} + +func main() { + ch := NewConsistentHash(3, func(key []byte) uint32 { + ret, _ := strconv.Atoi(string(key)) + return uint32(ret) + }) + ch.AddNode("1", "3", "5", "7") + testkeys := []string{"12", "4", "7", "8"} + for _, k := range testkeys { + fmt.Printf("k:%s,node:%s\n", k, ch.GetNode(k)) + } +} +``` + +### （Goroutine）有三个函数，分别打印"cat", "fish","dog"要求每一个函数都用一个goroutine，按照顺序打印100次。 + +此题目考察channel，用三个无缓冲channel，如果一个channel收到信号则通知下一个。 + +```go +package main + +import ( + "fmt" + "time" +) + +var dog = make(chan struct{}) +var cat = make(chan struct{}) +var fish = make(chan struct{}) + +func Dog() { + <-fish + fmt.Println("dog") + dog <- struct{}{} +} + +func Cat() { + <-dog + fmt.Println("cat") + cat <- struct{}{} +} + +func Fish() { + <-cat + fmt.Println("fish") + fish <- struct{}{} +} + +func main() { + for i := 0; i < 100; i++ { + go Dog() + go Cat() + go Fish() + } + fish <- struct{}{} + + time.Sleep(10 * time.Second) +} +``` + +### 两个协程交替打印10个字母和数字 + +思路：采用channel来协调goroutine之间顺序。 + +主线程一般要waitGroup等待协程退出，这里简化了一下直接sleep。 + +```go +package main + +import ( + "fmt" + "time" +) + +var word = make(chan struct{}, 1) +var num = make(chan struct{}, 1) + +func printNums() { + for i := 0; i < 10; i++ { + <-word + fmt.Println(1) + num <- struct{}{} + } +} +func printWords() { + for i := 0; i < 10; i++ { + <-num + fmt.Println("a") + word <- struct{}{} + } +} + +func main() { + num <- struct{}{} + go printNums() + go printWords() + time.Sleep(time.Second * 1) +} +``` + +代码： + + [@中二的灰太狼](https://www.zhihu.com/people/2d6eba22144ae58788cef3ed60485e9d) + +### 启动 2个groutine 2秒后取消， 第一个协程1秒执行完，第二个协程3秒执行完。 + +思路：采用`ctx, _ := context.WithTimeout(context.Background(), time.Second*2)`实现2s取消。协程执行完后通过channel通知，是否超时。 + +```go +package main + +import ( + "context" + "fmt" + "time" +) + +func f1(in chan struct{}) { + + time.Sleep(1 * time.Second) + in <- struct{}{} + +} + +func f2(in chan struct{}) { + time.Sleep(3 * time.Second) + in <- struct{}{} +} + +func main() { + ch1 := make(chan struct{}) + ch2 := make(chan struct{}) + ctx, _ := context.WithTimeout(context.Background(), 2*time.Second) + + go func() { + go f1(ch1) + select { + case <-ctx.Done(): + fmt.Println("f1 timeout") + break + case <-ch1: + fmt.Println("f1 done") + } + }() + + go func() { + go f2(ch2) + select { + case <-ctx.Done(): + fmt.Println("f2 timeout") + break + case <-ch2: + fmt.Println("f2 done") + } + }() + time.Sleep(time.Second * 5) +} +``` + +代码： + + [@中二的灰太狼](https://www.zhihu.com/people/2d6eba22144ae58788cef3ed60485e9d) + +### 当select监控多个chan同时到达就绪态时，如何先执行某个任务？ + +可以在子case再加一个for select语句。 + +```go +func priority_select(ch1, ch2 <-chan string) { + for { + select { + case val := <-ch1: + fmt.Println(val) + case val2 := <-ch2: + priority: + for { + select { + case val1 := <-ch1: + fmt.Println(val1) + + default: + break priority + } + } + fmt.Println(val2) + } + } + +} +``` \ No newline at end of file diff --git "a/docs/golang/\351\235\242\350\257\225\351\242\230/test.md" "b/docs/golang/\351\235\242\350\257\225\351\242\230/test.md" new file mode 100644 index 0000000..34eb5a3 --- /dev/null +++ "b/docs/golang/\351\235\242\350\257\225\351\242\230/test.md" @@ -0,0 +1,4279 @@ + +### 文章目录 + +* [SpringBoot](https://www.pudn.com/news/62d0d14055398e076b87721e.html#SpringBoot_0) +* * [1、SpringBoot入门](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1SpringBoot_7) + * * [1.1、Spring程序与SpringBoot程序对比](https://www.pudn.com/news/62d0d14055398e076b87721e.html#11SpringSpringBoot_9) + * [1.2、parent](https://www.pudn.com/news/62d0d14055398e076b87721e.html#12parent_13) + * [1.3、引导类](https://www.pudn.com/news/62d0d14055398e076b87721e.html#13_36) + * [1.4、内置Tomcat](https://www.pudn.com/news/62d0d14055398e076b87721e.html#14Tomcat_59) + * [2、Rest风格](https://www.pudn.com/news/62d0d14055398e076b87721e.html#2Rest_75) + * * [2.1、什么是Rest](https://www.pudn.com/news/62d0d14055398e076b87721e.html#21Rest_77) + * [2.2、Rest入门案例](https://www.pudn.com/news/62d0d14055398e076b87721e.html#22Rest_114) + * [2.3、Restful快速开发](https://www.pudn.com/news/62d0d14055398e076b87721e.html#23Restful_153) + * [3、配置文档](https://www.pudn.com/news/62d0d14055398e076b87721e.html#3_163) + * [3.1、基础配置](https://www.pudn.com/news/62d0d14055398e076b87721e.html#31_165) + * [3.2、配置文件类型](https://www.pudn.com/news/62d0d14055398e076b87721e.html#32_191) + * [3.3、配置文件加载优先级](https://www.pudn.com/news/62d0d14055398e076b87721e.html#33_221) + * [3.4、yaml数据格式](https://www.pudn.com/news/62d0d14055398e076b87721e.html#34yaml_230) + * [数据类型](https://www.pudn.com/news/62d0d14055398e076b87721e.html#_262) + * [3.5、读取yaml单一属性数据](https://www.pudn.com/news/62d0d14055398e076b87721e.html#35yaml_321) + * [3.6、yaml文件中的变量应用](https://www.pudn.com/news/62d0d14055398e076b87721e.html#36yaml_353) + * [3.7、读取yaml全部属性数据](https://www.pudn.com/news/62d0d14055398e076b87721e.html#37yaml_367) + * [3.8、读取yaml应用类型属性数据](https://www.pudn.com/news/62d0d14055398e076b87721e.html#38yaml_376) + * [4、SpringBoot整合JUnit](https://www.pudn.com/news/62d0d14055398e076b87721e.html#4SpringBootJUnit_430) + * * [4.1、整合JUnit](https://www.pudn.com/news/62d0d14055398e076b87721e.html#41JUnit_432) + * [4.2、整合JUnit——classes属性](https://www.pudn.com/news/62d0d14055398e076b87721e.html#42JUnitclasses_473) + * [5、SpringBoot整合MyBatis、MyBatisPlus](https://www.pudn.com/news/62d0d14055398e076b87721e.html#5SpringBootMyBatisMyBatisPlus_499) + * * [5.1、整合MyBatis](https://www.pudn.com/news/62d0d14055398e076b87721e.html#51MyBatis_501) + * [5.2、常见问题处理](https://www.pudn.com/news/62d0d14055398e076b87721e.html#52_597) + * [5.3、整合MyBatisPlus](https://www.pudn.com/news/62d0d14055398e076b87721e.html#53MyBatisPlus_614) + * [6、SpringBoot整合Druid](https://www.pudn.com/news/62d0d14055398e076b87721e.html#6SpringBootDruid_674) + * [7、SSMP](https://www.pudn.com/news/62d0d14055398e076b87721e.html#7SSMP_715) + * * [7.1、数据配置](https://www.pudn.com/news/62d0d14055398e076b87721e.html#71_717) + * [7.2、分页](https://www.pudn.com/news/62d0d14055398e076b87721e.html#72_934) + * [7.3、数据层标准开发](https://www.pudn.com/news/62d0d14055398e076b87721e.html#73_994) + * [7.4、业务层标准开发（基础CRUD）](https://www.pudn.com/news/62d0d14055398e076b87721e.html#74CRUD_1031) + * [7.5、业务层快速开发（基于MyBatisPlus构建）](https://www.pudn.com/news/62d0d14055398e076b87721e.html#75MyBatisPlus_1158) + * [7.7、表现层标准开发](https://www.pudn.com/news/62d0d14055398e076b87721e.html#77_1285) + * [7.8、表现层数据一致性处理（R对象）](https://www.pudn.com/news/62d0d14055398e076b87721e.html#78R_1357) + * [8、Springboot工程打包与运行](https://www.pudn.com/news/62d0d14055398e076b87721e.html#8Springboot_1448) + * * [8.1、程序为什么要打包](https://www.pudn.com/news/62d0d14055398e076b87721e.html#81_1450) + * [8.2、SpringBoot项目快速启动（Windows版）](https://www.pudn.com/news/62d0d14055398e076b87721e.html#82SpringBootWindows_1456) + * [8.3、打包插件](https://www.pudn.com/news/62d0d14055398e076b87721e.html#83_1511) + * [8.4、Boot工程快速启动](https://www.pudn.com/news/62d0d14055398e076b87721e.html#84Boot_1580) + * [8.6、临时属性](https://www.pudn.com/news/62d0d14055398e076b87721e.html#86_1635) + * * [8.6.1、临时属性](https://www.pudn.com/news/62d0d14055398e076b87721e.html#861_1637) + * [8.6.2、开发环境](https://www.pudn.com/news/62d0d14055398e076b87721e.html#862_1657) + * [8.7、配置环境](https://www.pudn.com/news/62d0d14055398e076b87721e.html#87_1688) + * * [8.7.1、配置文件分类](https://www.pudn.com/news/62d0d14055398e076b87721e.html#871_1691) + * [8.7.2、自定义配置文件](https://www.pudn.com/news/62d0d14055398e076b87721e.html#872_1711) + * [8.7.3、多环境开发（yaml）](https://www.pudn.com/news/62d0d14055398e076b87721e.html#873yaml_1745) + * [8.7.4、多环境开发文件（yaml）](https://www.pudn.com/news/62d0d14055398e076b87721e.html#874yaml_1783) + * [8.7.5、多环境分组管理](https://www.pudn.com/news/62d0d14055398e076b87721e.html#875_1821) + * [8.7.6、多环境开发控制](https://www.pudn.com/news/62d0d14055398e076b87721e.html#876_1871) + * [9、日志](https://www.pudn.com/news/62d0d14055398e076b87721e.html#9_1923) + * * [9.1、日志基础操作](https://www.pudn.com/news/62d0d14055398e076b87721e.html#91_1925) + * [9.2、快速创建日志对象](https://www.pudn.com/news/62d0d14055398e076b87721e.html#92_2006) + * [9.3、日志输出格式控制](https://www.pudn.com/news/62d0d14055398e076b87721e.html#93_2034) + * [9.4、文件记录日志](https://www.pudn.com/news/62d0d14055398e076b87721e.html#94_2061) + * [10、热部署](https://www.pudn.com/news/62d0d14055398e076b87721e.html#10_2084) + * [11、属性绑定](https://www.pudn.com/news/62d0d14055398e076b87721e.html#11_2113) + * [12、常用计量单位应用](https://www.pudn.com/news/62d0d14055398e076b87721e.html#12_2158) + * [13、测试类](https://www.pudn.com/news/62d0d14055398e076b87721e.html#13_2230) + * * [13.1、加载专用属性](https://www.pudn.com/news/62d0d14055398e076b87721e.html#131_2232) + * [13.2、加载专用类](https://www.pudn.com/news/62d0d14055398e076b87721e.html#132_2262) + * [13.3、业务层测试事务回滚](https://www.pudn.com/news/62d0d14055398e076b87721e.html#133_2381) + * [13.4、测试用例数据设定](https://www.pudn.com/news/62d0d14055398e076b87721e.html#134_2404) + * [14、数据层解决方案](https://www.pudn.com/news/62d0d14055398e076b87721e.html#14_2431) + * * [14.1、SQL](https://www.pudn.com/news/62d0d14055398e076b87721e.html#141SQL_2433) + * [14.2、MongoDB](https://www.pudn.com/news/62d0d14055398e076b87721e.html#142MongoDB_2641) + * * [14.2.1、MongoDB的使用](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1421MongoDB_2647) + * [14.2.2、MongoDB可视化客户端](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1422MongoDB_2671) + * [14.2.3、Springboot集成MongoDB](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1423SpringbootMongoDB_2689) + * [14.3、ElasticSearch（ES）](https://www.pudn.com/news/62d0d14055398e076b87721e.html#143ElasticSearchES_2730) + * * [14.3.1、ES下载](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1431ES_2738) + * [14.3.2、ES索引、分词器](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1432ES_2750) + * [14.3.3、文档操作（增删改查）](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1433_2792) + * [14.3.4、Springboot集成ES](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1434SpringbootES_2850) + * [14.3.5、索引](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1435_2939) + * [15、缓存](https://www.pudn.com/news/62d0d14055398e076b87721e.html#15_3057) + * * [15.1、缓存简介](https://www.pudn.com/news/62d0d14055398e076b87721e.html#151_3059) + * [15.2、缓存使用](https://www.pudn.com/news/62d0d14055398e076b87721e.html#152_3073) + * [15.3、其他缓存](https://www.pudn.com/news/62d0d14055398e076b87721e.html#153_3115) + * [15.4、缓存使用案例——手机验证码](https://www.pudn.com/news/62d0d14055398e076b87721e.html#154_3132) + * * [15.4.1、Cache](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1541Cache_3146) + * [15.4.2、Ehcache](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1542Ehcache_3217) + * [15.4.3、Redis](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1543Redis_3276) + * [15.4.4、memcached](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1544memcached_3316) + * [15.4.5、jetcache](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1545jetcache_3445) + * [15.4.6、j2cache](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1546j2cache_3652) + * [16、定时](https://www.pudn.com/news/62d0d14055398e076b87721e.html#16_3730) + * * [16.1、SpringBoot整合Quartz](https://www.pudn.com/news/62d0d14055398e076b87721e.html#161SpringBootQuartz_3745) + * [16.2、Spring Task](https://www.pudn.com/news/62d0d14055398e076b87721e.html#162Spring_Task_3795) + * [16.3、SpringBoot整合JavaMail](https://www.pudn.com/news/62d0d14055398e076b87721e.html#163SpringBootJavaMail_3841) + * [17、消息](https://www.pudn.com/news/62d0d14055398e076b87721e.html#17_3925) + * * [17.1、JMS](https://www.pudn.com/news/62d0d14055398e076b87721e.html#171JMS_3935) + * [17.2、AMQP](https://www.pudn.com/news/62d0d14055398e076b87721e.html#172AMQP_3954) + * [17.3、MQTT](https://www.pudn.com/news/62d0d14055398e076b87721e.html#173MQTT_3970) + * [17.4、Kafka](https://www.pudn.com/news/62d0d14055398e076b87721e.html#174Kafka_3976) + * [17.5、消息案例](https://www.pudn.com/news/62d0d14055398e076b87721e.html#175_3982) + * [17.6、ActiveMQ](https://www.pudn.com/news/62d0d14055398e076b87721e.html#176ActiveMQ_4000) + * * [17.6.1、SpringBoot整合ActiveMQ](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1761SpringBootActiveMQ_4018) + * [17.7、RabbitMQ](https://www.pudn.com/news/62d0d14055398e076b87721e.html#177RabbitMQ_4104) + * * [17.7.1、SpringBoot整合RabbitMQ](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1771SpringBootRabbitMQ_4148) + * [17.8、RocketMQ](https://www.pudn.com/news/62d0d14055398e076b87721e.html#178RocketMQ_4323) + * * [17.8.1、SpringBoot整合RocketMQ](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1781SpringBootRocketMQ_4358) + * [17.9、Kafka](https://www.pudn.com/news/62d0d14055398e076b87721e.html#179Kafka_4434) + * * [17.9.1、SpringBoot整合Kafka](https://www.pudn.com/news/62d0d14055398e076b87721e.html#1791SpringBootKafka_4476) + * [18、监控](https://www.pudn.com/news/62d0d14055398e076b87721e.html#18_4525) + * * [18.1、简介](https://www.pudn.com/news/62d0d14055398e076b87721e.html#181_4527) + * [18.2、可视化监控平台](https://www.pudn.com/news/62d0d14055398e076b87721e.html#182_4545) + * [18.3、监控原理](https://www.pudn.com/news/62d0d14055398e076b87721e.html#183_4658) + * [18.4、自定义监控指标](https://www.pudn.com/news/62d0d14055398e076b87721e.html#184_4703) + * [18.3、监控原理](https://www.pudn.com/news/62d0d14055398e076b87721e.html#183_4879) + * [18.4、自定义监控指标](https://www.pudn.com/news/62d0d14055398e076b87721e.html#184_4928) + +## 1、SpringBoot入门 + +### 1.1、Spring程序与SpringBoot程序对比 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/43e3ba472de049f9a489b0773ecf88a7.png) + +### 1.2、parent + +![在这里插入图片描述](https://img-blog.csdnimg.cn/51971e3edda741028356f6cd3947d4a2.png) + +* starter + + SpringBoot中常见项目名称，定义了当前项目使用的所有依赖坐标，以达到减少依赖配置的目的 + +* parent + + 所有SpringBoot项目要继承的项目，定义了若干个坐标版本号（依赖管理，而非依赖），以达到减少依赖冲突的目的 + + spring-boot-starter-parent各版本间存在着诸多坐标版本不同 + +* 实际开发 + + 使用任意坐标时，仅书写GAV(groupId, artifactId, version)中的G和A，V由SpringBoot提供，除非SpringBoot未提供对应版本V + + 如发生坐标错误，再指定Version（要小心版本冲突） + +### 1.3、引导类 + +* 启动方式 + + @SpringBootApplication + public class Springboot0101QuickstartApplication { + + public static void main(String[] args) { + ConfigurableApplicationContext ctx = SpringApplication.run(Springboot0101QuickstartApplication.class, args); + //获取bean对象 + BookController bean = ctx.getBean(BookController.class); + System.out.println("bean======>" + bean); + } + } + + SpringBoot的引导类是Boot工程的执行入口，运行main方法就可以启动项目 + + SpringBoot工程运行后初始化Spring容器，扫描引导类所在包加载bean + +### 1.4、内置Tomcat + +![在这里插入图片描述](https://img-blog.csdnimg.cn/17e3b9fb27e745dab90d4f73c4168c27.png) + +* Jetty比Tomcat更轻量级，可扩展性更强（相较于Tomcat），谷歌应用引擎（GAE）已经全面切换为Jetty + +* 内置服务器 + + tomcat(默认) apache出品，粉丝多，应用面广，负载了若干较重的组件 + + jetty 更轻量级，负载性能远不及tomcat + + undertow undertow，负载性能勉强跑赢tomcat + +## 2、Rest风格 + +### 2.1、什么是Rest + +1. 什么是 rest ： + + REST（Representational State Transfer）表现形式状态转换 + + 传统风格资源描述形式 + http://localhost/user/getById?id=1 (得到id为1的用户) + http://localhost/user/saveUser (保存用户) + + REST风格描述形式 + http://localhost/user/1 (得到id为1的用户) + http://localhost/user (保存用户) + +2. 优点: + + 隐藏资源的访问行为， 无法通过地址得知对资源是何种操作 + 书写简化 + +3. 按照REST风格访问资源时使用行为动作区分对资源进行了何种操作 + + GET 用来获取资源，POST 用来新建资源，PUT 用来更新资源，DELETE 用来删除资源 + + http://localhost/users 查询全部用户信息 GET (查询) + http://localhost/users/1 查询指定用户信息 GET (查询) + http://localhost/users 添加用户信息 POST (新增/保存) + http://localhost/users 修改用户信息 PUT (修改/更新) + http://localhost/users/1 删除用户信息 DELETE (删除) + +注意: + +上述行为是约定方式，约定不是规范，可以打破，所以称REST风格，而不是REST规范 +描述模块的名称通常使用复数，也就是加s的格式描述，表示此类资源,而非单个资源，例如: users、 + +1. 根据REST风格对资源进行访问称为**RESTful** + +### 2.2、Rest入门案例 + +步骤： + +①设定http请求动作(动词) + +使用 @RequestMapping 注解的 method 属性声明请求的方式 + +使用 @RequestBody 注解 获取请求体内容。直接使用得到是 key=value&key=value…结构的数据。get 请求方式不适用。 + +使用@ResponseBody 注解实现将 controller 方法返回对象转换为 json 响应给客户端。 + +@RequestMapping(value=“/users”,method=RequestMethod.POST) + +![在这里插入图片描述](https://img-blog.csdnimg.cn/0a4ded7bb220415bbcd779c230f2d94f.png) + +②:设定请求参数(路径变量) + +使用`@PathVariable` 用于绑定 url 中的占位符。例如：请求 url 中 /delete/`{id}`，这个`{id}`就是 url 占位符。 +![在这里插入图片描述](https://img-blog.csdnimg.cn/fd8f1fc9f45b429ebabf148df521d3e0.png) + +@RequestMapping + +![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-HhzZsWGO-1657811363433)(SpringBoot.assets/image-20220312164532116.png)]](https://img-blog.csdnimg.cn/7fb5465b71a346d4b2e8920493c5e36c.png) + +@PathVariable + +![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Yaepxdng-1657811363434)(SpringBoot.assets/image-20220312164552778.png)]](https://img-blog.csdnimg.cn/a9c22e3367a7480ea219baaa21de868e.png) + +@RequestBody @RequestParam @PathVariable +![在这里插入图片描述](https://img-blog.csdnimg.cn/1ce13dc308fe4147981ce26622eec1ca.png) + +### 2.3、Restful快速开发 + +使用 `@RestController` 注解开发 RESTful 风格 +![在这里插入图片描述](https://img-blog.csdnimg.cn/9e782ebc0c8b458ea30bd3132f9e7f57.png) + +使用 @GetMapping @PostMapping @PutMapping @DeleteMapping 简化 `@RequestMapping` 注解开发 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/4b55439a2e094dae84f37f2f59f7b0f2.png) + +### 3、配置文档 + +### 3.1、基础配置 + +1. 修改配置 + 修改服务器端口 + server.port=80 + 关闭运行日志图标（banner） + spring.main.banner-mode=off + 设置日志相关 + logging.level.root=debug + +# 服务器端口配置 +server.port=80 + +# 修改banner +# spring.main.banner-mode=off +# spring.banner.image.location=logo.png + +# 日志 +logging.level.root=info + +1. SpringBoot内置属性查询 + https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html#application-properties + 官方文档中参考文档第一项：Application Propertie + +### 3.2、配置文件类型 + +* 配置文件格式 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/cf1d1024f92142d69b1b1e30038a9434.png) + +* SpringBoot提供了多种属性配置方式 + + application.properties + + server.port=80 + + application.yml + + server: + port: 81 + + application.yaml + + server: + port: 82 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/aa8415068c074278ad3085414efc96c8.png) + +### 3.3、配置文件加载优先级 + +* SpringBoot配置文件加载顺序 + application.properties > application.yml > application.yaml +* 常用配置文件种类 + application.yml + +### 3.4、yaml数据格式 + +yaml + +YAML（YAML Ain’t Markup Language），一种数据序列化格式 + +优点： + 容易阅读 + 容易与脚本语言交互 + 以数据为核心，重数据轻格式 + +YAML文件扩展名 + .yml（主流） + .yaml + +yaml语法规则 +基本语法 + +key: value -> value 前面一定要有空格 +大小写敏感 +属性层级关系使用多行描述，每行结尾使用冒号结束 +使用缩进表示层级关系，同层级左侧对齐，只允许使用空格（不允许使用Tab键） +属性值前面添加空格（属性名与属性值之间使用冒号+空格作为分隔） +# 表示注释 +核心规则：数据前面要加空格与冒号隔开 server: + servlet: + context-path: /hello + port: 82 +### 数据类型 + +* 字面值表示方式 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/8f1261fad4f842d8ab8e8bd591d4aaf6.png) + +# 字面值表示方式 + +boolean: TRUE #TRUE,true,True,FALSE,false ， False 均可 +float: 3.14 #6.8523015e+5 # 支持科学计数法 +int: 123 #0b1010_0111_0100_1010_1110 # 支持二进制、八进制、十六进制 +# null: ~ # 使用 ~ 表示 null +string: HelloWorld # 字符串可以直接书写 +string2: "Hello World" # 可以使用双引号包裹特殊字符 +date: 2018-02-17 # 日期必须使用 yyyy-MM-dd 格式 +datetime: 2018-02-17T15:02:31+08:00 # 时间和日期之间使用 T 连接，最后使用 + 代表时区 + +* 数组表示方式：在属性名书写位置的下方使用减号作为数据开始符号，每行书写一个数据，减号与数据间空格分隔 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/450bae74c7904daf8c26854788698b18.png) + +subject: + - Java + - 前端 + - 大数据 + +enterprise: + name: zhangsan + age: 16 + +subject2: + - Java + - 前端 + - 大数据 +likes: [王者荣耀,刺激战场] # 数组书写缩略格式 + +users: # 对象数组格式 + - name: Tom + age: 4 + + - name: Jerry + age: 5 +users2: # 对象数组格式二 + - + name: Tom + age: 4 + - + name: Jerry + age: 5 + +# 对象数组缩略格式 +users3: [ { name:Tom , age:4 } , { name:Jerry , age:5 } ] +### 3.5、读取yaml单一属性数据 + +* 使用@Value读取单个数据，属性名引用方式：${一级属性名.二级属性名……} + ![在这里插入图片描述](https://img-blog.csdnimg.cn/332e7c2fc82449e29984c7caaa3f8c31.png) + + @Value("${country}") + private String country1; + + @Value("${user.age}") + private String age1; + + @Value("${likes[1]}") + private String likes1; + + @Value("${users[1].name}") + private String name1; + + @GetMapping + public String getById() { + System.out.println("springboot is running2..."); + System.out.println("country1=>" + country1); + System.out.println("age1=>" + age1); + System.out.println("likes1=>" + likes1); + System.out.println("name1=>" + name1); + return "springboot is running2..."; + } +### 3.6、yaml文件中的变量应用 + +* 在配置文件中可以使用属性名引用方式引用属性 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/519e7e02e15b4ae996a53faa03bfb44b.png) + ![在这里插入图片描述](https://img-blog.csdnimg.cn/d20085f899a84d9c81365897c8c01775.png) + +* 属性值中如果出现转移字符，需要使用双引号包裹 + + lesson: "Spring\tboot\nlesson" + +### 3.7、读取yaml全部属性数据 + +* 封装全部数据到Environment对象 +* 注意 要导这个 包 +* **import org.springframework.core.env.Environment** + ![在这里插入图片描述](https://img-blog.csdnimg.cn/e8e576fdf9244d9692f6dd8d92c18602.png) + ![在这里插入图片描述](https://img-blog.csdnimg.cn/0d64b9e6621a424999400a063743cb6d.png) + +### 3.8、读取yaml应用类型属性数据 + +* 自定义对象封装指定数据 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/feb05e9432c0461e87474bde8cbf5db1.png) + +* 自定义对象封装指定数据的作用 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/4ffb01bae1ba4e088750c5882ca71094.png) + +# 创建类，用于封装下面的数据 +# 由spring帮我们去加载数据到对象中，一定要告诉spring加载这组信息 +# 使用时候从spring中直接获取信息使用 + +datasource: + driver: com.mysql.jdbc.Driver + url: jdbc:mysql://localhost/springboot_db + username: root + password: root666123 //1.定义数据模型封装yaml文件中对应的数据 +//2.定义为spring管控的bean +@Component +//3.指定加载的数据 +@ConfigurationProperties(prefix = "datasource") +public class MyDataSource { + + private String driver; + private String url; + private String username; + private String password; + + //省略get/set/tostring 方法 +} + +使用自动装配封装指定数据 + + @Autowired + private MyDataSource myDataSource; + +输出查看 + +System.out.println(myDataSource); +## 4、SpringBoot整合JUnit + +### 4.1、整合JUnit + +* 添加Junit的起步依赖 Spring Initializr 创建时自带 + + + + org.springframework.boot + spring-boot-starter-test + test + +* SpringBoot整合JUnit + + @SpringBootTest + class Springboot07JunitApplicationTests { + @Autowired + private BookService bookService; + @Test + public void testSave(){ + bookService.save(); + } + } +* @SpringBootTest + 名称：@SpringBootTest + 类型：测试类注解 + 位置：测试类定义上方 + 作用：设置JUnit加载的SpringBoot启动类 + 范例： + + @SpringBootTest + class Springboot05JUnitApplicationTests {} + +### 4.2、整合JUnit——classes属性 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/11b8072d4158454d829dfaece9287625.png) + +@SpringBootTest(classes = Springboot04JunitApplication.class) +//@ContextConfiguration(classes = Springboot04JunitApplication.class) +class Springboot04JunitApplicationTests { + //1.注入你要测试的对象 + @Autowired + private BookDao bookDao; + + @Test + void contextLoads() { + //2.执行要测试的对象对应的方法 + bookDao.save(); + System.out.println("two..."); + } +} + +注意: + +* 如果测试类在SpringBoot启动类的包或子包中，可以省略启动类的设置，也就是省略classes的设定 + +## 5、SpringBoot整合MyBatis、MyBatisPlus + +### 5.1、整合MyBatis + +①：创建新模块，选择Spring初始化，并配置模块相关基础信息 + +②：选择当前模块需要使用的技术集（MyBatis、MySQL） + +③：设置数据源参数 + +#DB Configuration: +spring: + datasource: + driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/springboot_db + username: root + password: 123456 + +④：创建user表 +在 springboot_db 数据库中创建 user 表 + +-- ---------------------------- +-- Table structure for `user` +-- ---------------------------- +DROP TABLE IF EXISTS `user`; +CREATE TABLE `user` ( + `id` int(11) NOT NULL AUTO_INCREMENT, + `username` varchar(50) DEFAULT NULL, + `password` varchar(50) DEFAULT NULL, + `name` varchar(50) DEFAULT NULL, + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=10 DEFAULT CHARSET=utf8; + +-- ---------------------------- +-- Records of user +-- ---------------------------- +INSERT INTO `user` VALUES ('1', 'zhangsan', '123', '张三'); +INSERT INTO `user` VALUES ('2', 'lisi', '123', '李四'); + +⑤：创建实体Bean + +public class User { + // 主键 + private Long id; + // 用户名 + private String username; + // 密码 + private String password; + // 姓名 + private String name; + + //此处省略getter,setter,toString方法 .. .. + +} + +⑥: 定义数据层接口与映射配置 + +@Mapper +public interface UserDao { + + @Select("select * from user") + public List getAll(); +} + +⑦：测试类中注入dao接口，测试功能 + +@SpringBootTest +class Springboot05MybatisApplicationTests { + + @Autowired + private UserDao userDao; + + @Test + void contextLoads() { + List userList = userDao.getAll(); + System.out.println(userList); + } + +} + +⑧：运行如下 + +[User{id=1, username='zhangsan', password='123', name='张三'}, User{id=2, username='lisi', password='123', name='李四'}] +### 5.2、常见问题处理 + +SpringBoot版本低于2.4.3(不含)，Mysql驱动版本大于8.0时，需要在url连接串中配置时区 + +jdbc:mysql://localhost:3306/springboot_db?serverTimezone=UTC + +或在MySQL数据库端配置时区解决此问题 + +1.MySQL 8.X驱动强制要求设置时区 + +修改url，添加serverTimezone设定 +修改MySQL数据库配置（略） + +2.驱动类过时，提醒更换为com.mysql.cj.jdbc.Driver + +### 5.3、整合MyBatisPlus + +①：手动添加SpringBoot整合MyBatis-Plus的坐标，可以通过mvnrepository获取 + + + com.baomidou + mybatis-plus-boot-starter + 3.4.3 + + +注意事项: 由于SpringBoot中未收录MyBatis-Plus的坐标版本，需要指定对应的Version + +②：定义数据层接口与映射配置，继承BaseMapper + +@Mapper +public interface UserDao extends BaseMapper { + +} + +③：其他同SpringBoot整合MyBatis +（略） + +④：测试类中注入dao接口，测试功能 + +@SpringBootTest +class Springboot06MybatisPlusApplicationTests { + + @Autowired + private UserDao userDao; + + @Test + void contextLoads() { + List users = userDao.selectList(null); + System.out.println(users); + } + +} + +⑤: 运行如下: + +[User{id=1, username='zhangsan', password='123', name='张三'}, User{id=2, username='lisi', password='123', name='李四'}] + +注意: 如果你的数据库表有前缀要在 application.yml 添加如下配制 + +#设置Mp相关的配置 +mybatis-plus: + global-config: + db-config: + table-prefix: tbl_ +### 6、SpringBoot整合Druid + +①: 导入Druid对应的starter + + + com.alibaba + druid-spring-boot-starter + 1.2.6 + #DB Configuration: +spring: + datasource: + driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/springboot_db?serverTimezone=UTC + username: root + password: Lemon + type: com.alibaba.druid.pool.DruidDataSource + +②: 指定数据源类型 (这种方式只需导入一个 Druid 的坐标) + +spring: + datasource: + druid: + driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/springboot_db?serverTimezone=UTC + username: root + password: 123456 + +或者 变更Druid的配置方式(推荐) 这种方式需要导入 Druid对应的starter + +## 7、SSMP + +### 7.1、数据配置 + +1\. 案例实现方案分析 + 实体类开发————使用Lombok快速制作实体类 + Dao开发————整合MyBatisPlus，制作数据层测试类 + Service开发————基于MyBatisPlus进行增量开发，制作业务层测试类 + Controller开发————基于Restful开发，使用PostMan测试接口功能 + Controller开发————前后端开发协议制作 + 页面开发————基于VUE+ElementUI制作，前后端联调，页面数据处理，页面消息处理 + 列表、新增、修改、删除、分页、查询 + 项目异常处理 + 按条件查询————页面功能调整、Controller修正功能、Service修正功能 +2\. SSMP案例制作流程解析 + 先开发基础CRUD功能，做一层测一层 + 调通页面，确认异步提交成功后，制作所有功能 + 添加分页功能与查询功能 DROP TABLE IF EXISTS `tbl_book`; +CREATE TABLE `tbl_book` ( + `id` int(11) NOT NULL AUTO_INCREMENT, + `type` varchar(20) DEFAULT NULL, + `name` varchar(50) DEFAULT NULL, + `description` varchar(255) DEFAULT NULL, + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=13 DEFAULT CHARSET=utf8; + +-- ---------------------------- +-- Records of tbl_book +-- ---------------------------- +INSERT INTO `tbl_book` VALUES ('1', '计算机理论', 'Spring实战第5版', 'Spring入门经典教程,深入理解Spring原理技术内幕'); +INSERT INTO `tbl_book` VALUES ('2', '计算机理论', 'Spring 5核心原理与30个类手写实战', '十年沉淀之作，写Spring精华思想'); +INSERT INTO `tbl_book` VALUES ('3', '计算机理论', 'Spring 5设计模式', '深入Spring源码剖析Spring源码中蕴含的10大设计模式'); +INSERT INTO `tbl_book` VALUES ('4', '计算机理论', 'Spring MVC+ MyBatis开发从入门到项目实战', '全方位解析面向Web应用的轻量级框架,带你成为Spring MVC开发高手'); +INSERT INTO `tbl_book` VALUES ('5', '计算机理论', '轻量级Java Web企业应用实战', '源码级剖析Spring框架,适合已掌握Java基础的读者'); +INSERT INTO `tbl_book` VALUES ('6', '计算机理论', 'Java核心技术卷|基础知识(原书第11版)', 'Core Java第11版，Jolt大奖获奖作品，针对Java SE9、10、 11全面更新'); +INSERT INTO `tbl_book` VALUES ('7', '计算机理论', '深入理解Java虚拟机', '5个维度全面剖析JVM,面试知识点全覆盖'); +INSERT INTO `tbl_book` VALUES ('8', '计算机理论', 'Java编程思想(第4版)', 'Java学习必读经典殿堂级著作!赢得了全球程序员的广泛赞誉'); +INSERT INTO `tbl_book` VALUES ('9', '计算机理论', '零基础学Java (全彩版)', '零基础自学编程的入门]图书，由浅入深，详解Java语言的编程思想和核心技术'); +INSERT INTO `tbl_book` VALUES ('10', '市场营销', '直播就该这么做:主播高效沟通实战指南', '李子柒、李佳琦、薇娅成长为网红的秘密都在书中'); +INSERT INTO `tbl_book` VALUES ('11', '市场营销', '直播销讲实战一本通', '和秋叶一起学系列网络营销书籍'); +INSERT INTO `tbl_book` VALUES ('12', '市场营销', '直播带货:淘宝、天猫直播从新手到高手', '一本教你如何玩转直播的书， 10堂课轻松实现带货月入3W+'); + + org.springframework.boot + spring-boot-starter-web + + + + mysql + mysql-connector-java + runtime + + + + com.baomidou + mybatis-plus-boot-starter + 3.4.3 + + + + com.alibaba + druid-spring-boot-starter + 1.2.6 + + + + org.springframework.boot + spring-boot-starter-test + test + + + + + org.projectlombok + lombok + + + + com.baomidou + mybatis-plus-boot-starter + 3.4.3 + + + + com.alibaba + druid-spring-boot-starter + 1.2.6 + + + server: + port: 80 +# druid 数据源配制 +spring: + datasource: + druid: + driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/springboot?serverTimezone=UTC + username: root + password: Lemon + +# mybatis-plus +mybatis-plus: + global-config: + db-config: + table-prefix: tbl_ + id-type: auto # 主键策略 + +Book.class + +@Data +public class Book { + private Integer id; + private String type; + private String name; + private String description; +} + +BookDao.class + +@Mapper +public interface BookDao extends BaseMapper { + + /** + * 查询一个 + * 这是 Mybatis 开发 + * @param id + * @return + */ + @Select("select * from tbl_book where id = #{id}") + Book getById(Integer id); +} + +测试类 + +@SpringBootTest +public class BookDaoTestCase { + + @Autowired + private BookDao bookDao; + + @Test + void testGetById() { + System.out.println(bookDao.getById(1)); + System.out.println(bookDao.selectById(1)); + } + + @Test + void testSave() { + Book book = new Book(); + book.setType("测试数据123"); + book.setName("测试数据123"); + book.setDescription("测试数据123"); + bookDao.insert(book); + } + + @Test + void testUpdate() { + Book book = new Book(); + book.setId(13); + book.setType("测试数据asfd"); + book.setName("测试数据123"); + book.setDescription("测试数据123"); + bookDao.updateById(book); + } + + @Test + void testDelete() { + bookDao.deleteById(13); + } + + @Test + void testGetAll() { + System.out.println(bookDao.selectList(null)); + } + + @Test + void testGetPage() { + } + + @Test + void testGetBy() { + } +} + +开启MybatisPlus运行日志 + +# mybatis-plus +mybatis-plus: + global-config: + db-config: + table-prefix: tbl_ + id-type: auto # 主键策略 + configuration: + # 开启MyBatisPlus的日志 + log-impl: org.apache.ibatis.logging.stdout.StdOutImpl +### 7.2、分页 + +分页操作需要设定分页对象IPage + +@Test +void testGetPage() { + IPage page = new Page(1, 5); + bookDao.selectPage(page, null); +} + +* IPage对象中封装了分页操作中的所有数据 + + 数据 + + 当前页码值 + + 每页数据总量 + + 最大页码值 + + 数据总量 + +* 分页操作是在MyBatisPlus的常规操作基础上增强得到，内部是动态的拼写SQL语句，因此需要增强对应的功能 + +使用MyBatisPlus拦截器实现 + +@Configuration +public class MybatisPlusConfig { + + @Bean + public MybatisPlusInterceptor mybatisPlusInterceptor() { + //1\. 定义 Mp 拦截器 + MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); + //2\. 添加具体的拦截器 分页拦截器 + interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); + return interceptor; + } +} + +测试 + +@Test +void testGetPage() { + IPage page = new Page(1, 5); + bookDao.selectPage(page, null); + System.out.println(page.getCurrent()); + System.out.println(page.getSize()); + System.out.println(page.getPages()); + System.out.println(page.getTotal()); + System.out.println(page.getRecords()); +} +### 7.3、数据层标准开发 + +* 使用QueryWrapper对象封装查询条件，推荐使用LambdaQueryWrapper对象，所有查询操作封装成方法调用 + +@Test +void testGetBy2() { + LambdaQueryWrapper lambdaQueryWrapper = new LambdaQueryWrapper<>(); + lambdaQueryWrapper.like(Book::getName, "Spring"); + bookDao.selectList(lambdaQueryWrapper); +} @Test +void testGetBy() { + QueryWrapper queryWrapper = new QueryWrapper<>(); + queryWrapper.like("name", "Spring"); + bookDao.selectList(queryWrapper); +} + +* 支持动态拼写查询条件 + +@Test +void testGetBy2() { + String name = "1"; + LambdaQueryWrapper lambdaQueryWrapper = new LambdaQueryWrapper<>(); + //if (name != null) lambdaQueryWrapper.like(Book::getName,name); + lambdaQueryWrapper.like(Strings.isNotEmpty(name), Book::getName, name); + bookDao.selectList(lambdaQueryWrapper); +} +### 7.4、业务层标准开发（基础CRUD） + +* Service层接口定义与数据层接口定义具有较大区别，不要混用 + selectByUserNameAndPassword(String username,String password); 数据层接口 + login(String username,String password); Service层接口 + +* 接口定义 + + public interface BookService { + + Boolean save(Book book); + + Boolean update(Book book); + + Boolean delete(Integer id); + + Book getById(Integer id); + + List getAll(); + + IPage getPage(int currentPage,int pageSize); + } +* 实现类定义 + +@Service +public class BookServiceImpl implements BookService { + + @Autowired + private BookDao bookDao; + + @Override + public Boolean save(Book book) { + return bookDao.insert(book) > 0; + } + + @Override + public Boolean update(Book book) { + return bookDao.updateById(book) > 0; + } + + @Override + public Boolean delete(Integer id) { + return bookDao.deleteById(id) > 0; + } + + @Override + public Book getById(Integer id) { + return bookDao.selectById(id); + } + + @Override + public List getAll() { + return bookDao.selectList(null); + } + + @Override + public IPage getPage(int currentPage, int pageSize) { + IPage page = new Page(currentPage, pageSize); + bookDao.selectPage(page, null); + return page; + } +} + +* 测试类定义 + +@SpringBootTest +public class BookServiceTestCase { + + @Autowired + private BookService bookService; + + @Test + void testGetById() { + System.out.println(bookService.getById(4)); + } + + @Test + void testSave() { + Book book = new Book(); + book.setType("测试数据123"); + book.setName("测试数据123"); + book.setDescription("测试数据123"); + bookService.save(book); + } + + @Test + void testUpdate() { + Book book = new Book(); + book.setId(14); + book.setType("测试数据asfd"); + book.setName("测试数据123"); + book.setDescription("测试数据123"); + bookService.update(book); + } + + @Test + void testDelete() { + bookService.delete(14); + } + + @Test + void testGetAll() { + System.out.println(bookService.getAll()); + } + + @Test + void testGetPage() { + IPage page = bookService.getPage(2, 5); + System.out.println(page.getCurrent()); + System.out.println(page.getSize()); + System.out.println(page.getPages()); + System.out.println(page.getTotal()); + System.out.println(page.getRecords()); + } +} +### 7.5、业务层快速开发（基于MyBatisPlus构建） + +* 快速开发方案 + + 使用MyBatisPlus提供有业务层通用接口（ISerivce）与业务层通用实现类（ServiceImpl） + + 在通用类基础上做功能重载或功能追加 + + 注意重载时不要覆盖原始操作，避免原始提供的功能丢失 + +* 接口定义 + +public interface IBookService extends IService { +} + +* 接口追加功能 + +public interface IBookService extends IService { + + // 追加的操作与原始操作通过名称区分，功能类似 + Boolean delete(Integer id); + + Boolean insert(Book book); + + Boolean modify(Book book); + + Book get(Integer id); +} + +![在这里插入图片描述](https://img-blog.csdnimg.cn/ac8db44e41344a03964803b29491c6a6.png) + +* 实现类定义 + +@Service +public class BookServiceImpl extends ServiceImpl implements IBookService { +} + +* 实现类追加功能 + +@Service +public class BookServiceImpl extends ServiceImpl implements IBookService { + + @Autowired + private BookDao bookDao; + + public Boolean insert(Book book) { + return bookDao.insert(book) > 0; + } + + public Boolean modify(Book book) { + return bookDao.updateById(book) > 0; + } + + public Boolean delete(Integer id) { + return bookDao.deleteById(id) > 0; + } + + public Book get(Integer id) { + return bookDao.selectById(id); + } +} + +* 测试类定义 + +@SpringBootTest +public class BookServiceTest { + + @Autowired + private IBookService bookService; + + @Test + void testGetById() { + System.out.println(bookService.getById(4)); + } + + @Test + void testSave() { + Book book = new Book(); + book.setType("测试数据123"); + book.setName("测试数据123"); + book.setDescription("测试数据123"); + bookService.save(book); + } + + @Test + void testUpdate() { + Book book = new Book(); + book.setId(14); + book.setType("==========="); + book.setName("测试数据123"); + book.setDescription("测试数据123"); + bookService.updateById(book); + } + + @Test + void testDelete() { + bookService.removeById(14); + } + + @Test + void testGetAll() { + System.out.println(bookService.list()); + } + + @Test + void testGetPage() { + IPage page = new Page<>(2, 5); + bookService.page(page); + System.out.println(page.getCurrent()); + System.out.println(page.getSize()); + System.out.println(page.getPages()); + System.out.println(page.getTotal()); + System.out.println(page.getRecords()); + } +} +### 7.7、表现层标准开发 + +* 基于Restful进行表现层接口开发 +* 使用Postman测试表现层接口功能 + +@RestController +@RequestMapping("/books") +public class BookController { + + @Autowired + private IBookService bookService; + + @GetMapping + public List getAll() { + return bookService.list(); + } + + @PostMapping + public Boolean save(@RequestBody Book book) { + return bookService.save(book); + } + + @PutMapping + public Boolean update(@RequestBody Book book) { + return bookService.modify(book); + } + + @DeleteMapping("{id}") + public Boolean delete(@PathVariable Integer id) { + return bookService.delete(id); + } + + @GetMapping("{id}") + public Book getById(@PathVariable Integer id) { + return bookService.getById(id); + } + + @GetMapping("{currentPage}/{pageSize}") + public IPage getPage(@PathVariable Integer currentPage, @PathVariable int pageSize) { + return bookService.getPage(currentPage, pageSize); + } + +} + +添加 分页的业务层方法 + +IBookService + + IPage getPage(int currentPage,int pageSize); + +BookServiceImpl + +@Override +public IPage getPage(int currentPage, int pageSize) { + + IPage page = new Page(currentPage, pageSize); + bookDao.selectPage(page, null); + + return page; +} + +![在这里插入图片描述](https://img-blog.csdnimg.cn/6f1ad431b53e47229e88f1898ff062de.png) +![在这里插入图片描述](https://img-blog.csdnimg.cn/2fc40d92ea0846c7b38142f9e755ed77.png) +![在这里插入图片描述](https://img-blog.csdnimg.cn/f1c3c746038b49619af5de1b04e7935f.png) + +### 7.8、表现层数据一致性处理（R对象） + +统一格式 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/a1ca89547dba4aeb9b164e195e572e6a.png) +![在这里插入图片描述](https://img-blog.csdnimg.cn/ee0fa35fce3542b4991d3be29736a2bb.png) + +* 设计表现层返回结果的模型类，用于后端与前端进行数据格式统一，也称为**前后端数据协议** + +@Data +public class R { + private Boolean flag; + private Object data; + + public R() { + } + + /** + * 不返回数据的构造方法 + * + * @param flag + */ + public R(Boolean flag) { + this.flag = flag; + } + + /** + * 返回数据的构造方法 + * + * @param flag + * @param data + */ + public R(Boolean flag, Object data) { + this.flag = flag; + this.data = data; + } +} + +* 表现层接口统一返回值类型结果 + +@RestController +@RequestMapping("/books") +public class BookController { + + @Autowired + private IBookService bookService; + + @GetMapping + public R getAll() { + return new R(true, bookService.list()); + } + + @PostMapping + public R save(@RequestBody Book book) { + return new R(bookService.save(book)); + + } + + @PutMapping + public R update(@RequestBody Book book) { + return new R(bookService.modify(book)); + } + + @DeleteMapping("{id}") + public R delete(@PathVariable Integer id) { + return new R(bookService.delete(id)); + } + + @GetMapping("{id}") + public R getById(@PathVariable Integer id) { + return new R(true, bookService.getById(id)); + } + + @GetMapping("{currentPage}/{pageSize}") + public R getPage(@PathVariable Integer currentPage, @PathVariable int pageSize) { + return new R(true, bookService.getPage(currentPage, pageSize)); + } + +} + +![在这里插入图片描述](https://img-blog.csdnimg.cn/c0c4ac51439b4d418abc0dcbbea2862c.png) + +**前端部分省略** + +## 8、Springboot工程打包与运行 + +### 8.1、程序为什么要打包 + +将程序部署在独立的服务器上 +![在这里插入图片描述](https://img-blog.csdnimg.cn/cf0d396d48bb49fa9c55847904a5f0b1.png) + +### 8.2、SpringBoot项目快速启动（Windows版） + +步骤 + +①：对SpringBoot项目打包（执行[Maven](https://so.csdn.net/so/search?q=Maven&spm=1001.2101.3001.7020)构建指令package） +执行 package 打包命令之前 先执行 **mvn clean** 删除 target 目录及内容 + +mvn package + +![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Eg4DFXqd-1657811363451)(SpringBoot.assets/image-20220317212408717.png)]](https://img-blog.csdnimg.cn/a19f1b3a110349cd9e16dbbd229ded5e.png) + +打包完成 生成对应的 jar 文件 +![在这里插入图片描述](https://img-blog.csdnimg.cn/9b4a4c84a82a44328fced7242662b4b8.png) + +可能出现的问题: IDEA下 执行 Maven 命令控制台中文乱码 +Ctr+Alt+S 打开设置，在Build，Execution ，Deployment找到Build Tools下Maven项下的Runner ，在VM Options 添加 +-Dfile.encoding=GB2312 ，点击OK。 +![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Z5rHQGqK-1657811363452)(SpringBoot.assets/image-20220317212514627.png)]](https://img-blog.csdnimg.cn/74c0cddee08a4766bf1390fb3f7fac3f.png) + +②：运行项目（执行启动指令） java -jar <打包文件名> + +java –jar springboot.jar + +注意事项： +jar支持命令行启动需要依赖maven插件支持，请确认打包时是否具有SpringBoot对应的maven插件 + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + +![在这里插入图片描述](https://img-blog.csdnimg.cn/bbd941c93bed424e88de917ee0f8f406.png) + +地址栏输入 cmd 回车 +![在这里插入图片描述](https://img-blog.csdnimg.cn/db84686fb76149ce85ed43d38a91b783.png) + +执行 java -jar springboot_08_ssmp-0.0.1-SNAPSHOT.jar +![在这里插入图片描述](https://img-blog.csdnimg.cn/e2c9fa1457f44b62affb67d232ae9bf4.png) + +打包优化：跳过 test 生命周期 +![在这里插入图片描述](https://img-blog.csdnimg.cn/3ab5f5b1493346c6876ae477f1930402.png) +![在这里插入图片描述](https://img-blog.csdnimg.cn/1c91e19c0c1e4e57b8a313c93141249d.png) + +### 8.3、打包插件 + +如果没有配制spring boot 打包插件可能遇到下面的问题: +![在这里插入图片描述](https://img-blog.csdnimg.cn/7e7f2f26252240a5b0997570a230b3f1.png) + +使用SpringBoot提供的maven插件可以将工程打包成可执行jar包 + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + +可执行jar包目录 +![在这里插入图片描述](https://img-blog.csdnimg.cn/ab51e088e01643a384a434f8961dde04.png) + +ar包描述文件（MANIFEST.MF） + +普通工程 + +Manifest-Version: 1.0 +Implementation-Title: springboot_08_ssmp +Implementation-Version: 0.0.1-SNAPSHOT +Build-Jdk-Spec: 1.8 +Created-By: Maven Jar Plugin 3.2.0 + +基于spring-boot-maven-plugin打包的工程 + +Manifest-Version: 1.0 +Spring-Boot-Classpath-Index: BOOT-INF/classpath.idx +Implementation-Title: springboot_08_ssmp +Implementation-Version: 0.0.1-SNAPSHOT +Spring-Boot-Layers-Index: BOOT-INF/layers.idx +Start-Class: com.example.SSMPApplication 启动类 +Spring-Boot-Classes: BOOT-INF/classes/ +Spring-Boot-Lib: BOOT-INF/lib/ +Build-Jdk-Spec: 1.8 +Spring-Boot-Version: 2.5.6 +Created-By: Maven Jar Plugin 3.2.0 +Main-Class: org.springframework.boot.loader.JarLauncher jar启动器 + +命令行启动常见问题及解决方案 + +* Windonws端口被占用 + +# 查询端口 +netstat -ano +# 查询指定端口 +netstat -ano |findstr "端口号" +# 根据进程PID查询进程名称 +tasklist |findstr "进程PID号" +# 根据PID杀死任务 +taskkill /F /PID "进程PID号" +# 根据进程名称杀死任务 +taskkill -f -t -im "进程名称" +### 8.4、Boot工程快速启动 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/a23a18d50a0246b89bf02a2ffeb549e2.png) + +* 基于Linux（CenterOS7） + +* 安装JDK，且版本不低于打包时使用的JDK版本 + + * 可以使用 yum 安装 +* 安装 MySQL + + * 可以参考: https://blog.csdn.net/qq_42324086/article/details/120579197 +* 安装包保存在/usr/local/自定义目录中或$HOME下 + +* 其他操作参照Windows版进行 + +**启动成功无法访问** + +添加 80 端口 + +* 添加 端口 + +firewall-cmd --zone=public --permanent --add-port=80/tcp + +重启 + +systemctl restart firewalld + +后台启动命令 + +nohup java -jar springboot_08_ssmp-0.0.1-SNAPSHOT.jar > server.log 2>&1 & + +停止服务 + +* ps -ef | grep “java -jar” +* kill -9 PID +* cat server.log (查看日志) + +[root@cjbCentos01 app]# ps -ef | grep "java -jar" +UID PID PPID C STIME TTY TIME CMD +root 6848 6021 7 14:45 pts/2 00:00:19 java -jar springboot_08_ssmp-0.0.1-SNAPSHOT.jar +root 6919 6021 0 14:49 pts/2 00:00:00 grep --color=auto java -jar +[root@cjbCentos01 app]# kill -9 6848 +[root@cjbCentos01 app]# ps -ef | grep "java -jar" +root 7016 6021 0 14:52 pts/2 00:00:00 grep --color=auto java -jar +[1]+ 已杀死 nohup java -jar springboot_08_ssmp-0.0.1-SNAPSHOT.jar > server.log 2>&1 +[root@cjbCentos01 app]# +### 8.6、临时属性 + +#### 8.6.1、临时属性 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/5b127fc48b0a44639d06f08bc0bd977c.png) + +* 带属性数启动SpringBoot + +java -jar springboot_08_ssmp-0.0.1-SNAPSHOT.jar --server.port=8080 + +* 携带多个属性启动SpringBoot，属性间使用空格分隔 + +属性加载优先顺序 + +1. 参看 https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config + ![在这里插入图片描述](https://img-blog.csdnimg.cn/945e0efcbcad4926a418bdad28e1be08.png) + +#### 8.6.2、开发环境 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/29a1d15b010747c0977800bea5d0e007.png) + +* 带属性启动SpringBoot程序，为程序添加运行属性 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/13411376a16645bf8bae8fbcf6fc4964.png) + ![在这里插入图片描述](https://img-blog.csdnimg.cn/57e571fe9ce641bba055af96dce44e5d.png) + +在启动类中 main 可以通过 System.out.println(Arrays.toString(args)); 查看配制的属性 + +通过编程形式带参数启动SpringBoot程序，为程序添加运行参数 + +public static void main(String[] args) { + String[] arg = new String[1]; + arg[0] = "--server.port=8080"; + SpringApplication.run(SSMPApplication.class, arg); +} + +不携带参数启动SpringBoot程序 + +public static void main(String[] args) { + //可以在启动boot程序时断开读取外部临时配置对应的入口，也就是去掉读取外部参数的形参 + SpringApplication.run(SSMPApplication.class); +} +### 8.7、配置环境 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/205956af5f974a54a1e4c10015dae30d.png) + +#### 8.7.1、配置文件分类 + +* SpringBoot中4级配置文件 + + * 1级：file ：config/application.yml 【最高】 + + * 2级：file ：application.yml + + * 3级：classpath：config/application.yml + + * 4级：classpath：application.yml 【最低】 + +* 作用： + + * 1级与2级留做系统打包后设置通用属性，1级常用于运维经理进行线上整体项目部署方案调控 + + * 3级与4级用于系统开发阶段设置通用属性，3级常用于项目经理进行整体项目属性调控 + +#### 8.7.2、自定义配置文件 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/de7f3627fec54dd2852e44890f192b1d.png) + +通过启动参数加载配置文件（无需书写配置文件扩展名) --spring.config.name=eban +![在这里插入图片描述](https://img-blog.csdnimg.cn/70cebcbbd6c84a8eac3f9e997dca9a38.png) + +properties与yml文件格式均支持 + +* 通过启动参数加载指定文件路径下的配置文件 --spring.config.location=classpath:/ebank.yml + ![在这里插入图片描述](https://img-blog.csdnimg.cn/135c2375c371451e9bd86eee59f64668.png) + +properties与yml文件格式均支持 + +* 通过启动参数加载指定文件路径下的配置文件时可以加载多个配置,后面的会覆盖前面的 + +--spring.config.location=classpath:/ebank.yml,classpath:/ebank-server.yml + +![在这里插入图片描述](https://img-blog.csdnimg.cn/dc8e74a2c8c74d379f0869260493e458.png) + +注意事项: +多配置文件常用于将配置进行分类，进行独立管理，或将可选配置单独制作便于上线更新维护 + +自定义配置文件——重要说明 + +* 单服务器项目：使用自定义配置文件需求较低 + +* 多服务器项目：使用自定义配置文件需求较高，将所有配置放置在一个目录中，统一管理 + +* 基于SpringCloud技术，所有的服务器将不再设置配置文件，而是通过配置中心进行设定，动态加载配置信息 + +#### 8.7.3、多环境开发（yaml） + +![在这里插入图片描述](https://img-blog.csdnimg.cn/6aa91cdd68fd4e74aefce1746f502c5c.png) +![在这里插入图片描述](https://img-blog.csdnimg.cn/a286e356b075446e852abbaeea3b02bd.png) +![在这里插入图片描述](https://img-blog.csdnimg.cn/f331e0b270dd4a23afe009c231694d9e.png) + +#应用环境 +#公共配制 +spring: + profiles: + active: dev + +#设置环境 +#开发环境 +--- +spring: + config: + activate: + on-profile: dev +server: + port: 81 + +#生产环境 +--- +spring: + profiles: pro +server: + port: 80 + +#测试环境 +--- +spring: + profiles: test +server: + port: 82 +#### 8.7.4、多环境开发文件（yaml） + +![在这里插入图片描述](https://img-blog.csdnimg.cn/31e2fdc7804242488e594f9a04352d29.png) + +多环境开发（YAML版）多配置文件格式 +主启动配置文件application.yml + +#应用环境 +#公共配制 +spring: + profiles: + active: test + +环境分类配置文件application-pro.yml + +server: + port: 81 + +环境分类配置文件application-dev.yml + +server: + port: 82 + +环境分类配置文件application-test.yml + +server: + port: 83 +#### 8.7.5、多环境分组管理 + +* 根据功能对配置文件中的信息进行拆分，并制作成独立的配置文件，命名规则如下 + + * application-devDB.yml + + * application-devRedis.yml + + * application-devMVC.yml + +* 使用include属性在激活指定环境的情况下，同时对多个环境进行加载使其生效，多个环境间使用逗号分隔 + + spring: + profiles: + active: dev + include: devDB,devMVC + + 注意事项: + **当主环境dev与其他环境有相同属性时，主环境属性生效；其他环境中有相同属性时，最后加载的环境属性生效** + + The following profiles are active: devDB,devMVC,dev +* 从Spring2.4版开始使用group属性替代include属性，降低了配置书写量 + +* 使用**group**属性定义多种主环境与子环境的包含关系 + +spring: + profiles: + active: dev + group: + "dev": devDB,devMVC + "pro": proDB,proMVC + "test": testDB,testRedis,testMVC + +注意事项: +**使用group属性，会覆盖 主环境dev (active) 的内容，最后加载的环境属性生效** + +The following profiles are active: dev,devDB,devMVC +#### 8.7.6、多环境开发控制 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/7cac87f3998c403db8301a601178c9e8.png) +Maven与SpringBoot多环境兼容 +①：Maven中设置多环境属性 + + + + + dev_env + + dev + + + true + + + + pro_env + + pro + + + + + test_env + + test + + + + +②：SpringBoot中引用Maven属性 + +spring: + profiles: + active: @profile.active@ + group: + "dev": devDB,devMVC + "pro": proDB,proMVC + +![在这里插入图片描述](https://img-blog.csdnimg.cn/706db57f170d4b42ab1c71e4fd02888e.png) + +③：执行Maven打包指令，并在生成的boot打包文件.jar文件中查看对应信息 +问题：**修改pom.xml 文件后，启动没有生效 手动 compile 即可** +![在这里插入图片描述](https://img-blog.csdnimg.cn/41ea64df2c1b4e5393eaabfb1410ea4c.png) + +或者 设置 IDEA进行自动编译 +![在这里插入图片描述](https://img-blog.csdnimg.cn/281978a65c304f43a811da62b26ac626.png) + +## 9、日志 + +### 9.1、日志基础操作 + +日志（log）作用 + +1. 编程期调试代码 +2. 运营期记录信息 + * 记录日常运营重要信息（峰值流量、平均响应时长……） + * 记录应用报错信息（错误堆栈） + * 记录运维过程数据（扩容、宕机、报警……） + +代码中使用日志工具记录日志 + +* 先引入 Lombok 工具类 + + + + org.projectlombok + lombok + + + ①：添加日志记录操作 + + @RestController + @RequestMapping("/books") + public class BookController { + private static final Logger log = LoggerFactory.getLogger(BookController.class); + + @GetMapping + public String getById() { + System.out.println("springboot is running..."); + log.debug("debug ..."); + log.info("info ..."); + log.warn("warn ..."); + log.error("error ..."); + return "springboot is running..."; + } + } +* 日志级别 + +TRACE：运行堆栈信息，使用率低 +DEBUG：程序员调试代码使用 +INFO：记录运维过程数据 +WARN：记录运维过程报警数据 +ERROR：记录错误堆栈信息 +FATAL：灾难信息，合并计入ERRO + +②：设置日志输出级别 + +# 开启 debug 模式，输出调试信息，常用于检查系统运行状况 +debug: true +# 设置日志级别， root 表示根节点，即整体应用日志级别 +logging: + level: + root: debug + +③：设置日志组，控制指定包对应的日志输出级别，也可以直接控制指定包对应的日志输出级别 + +logging: + # 设置分组 + group: + # 自定义组名，设置当前组中所包含的包 + ebank: com.example.controller,com.example.service,com.example.dao + iservice: com.alibaba + level: + root: info + # 设置某个包的日志级别 +# com.example.controller: debug + # 为对应组设置日志级别 + ebank: warn +### 9.2、快速创建日志对象 + +* 使用lombok提供的注解@Slf4j简化开发，减少日志对象的声明操作 + + @Slf4j + //Rest模式 + @RestController + @RequestMapping("/books") + public class BookController { + + @GetMapping + public String getById(){ + System.out.println("springboot is running...2"); + + log.debug("debug..."); + log.info("info..."); + log.warn("warn..."); + log.error("error..."); + + return "springboot is running...2"; + } + + } + +### 9.3、日志输出格式控制 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/7b1ae90e16854890af7661f94570bd5d.png) + +* PID：进程ID，用于表明当前操作所处的进程，当多服务同时记录日志时，该值可用于协助程序员调试程序 +* 所属类/接口名：当前显示信息为SpringBoot重写后的信息，名称过长时，简化包名书写为首字母，甚至直接删除 +* 设置日志输出格式 + +logging: + pattern: + console: "%d - %m%n" + +%d：日期 +%m：消息 +%n：换行 +![在这里插入图片描述](https://img-blog.csdnimg.cn/91223acd27344b03ace835d17d35dd95.png) + +logging: +pattern: +# console: "%d - %m%n" +console: "%d %clr(%5p) --- [%16t] %clr(%-40.40c){cyan} : %m %n" +### 9.4、文件记录日志 + +* 设置日志文件 + +logging: + file: + name: server.log + +* 日志文件详细配置 + +logging: + file: + name: server.log + logback: + rollingpolicy: + max-file-size: 4KB + file-name-pattern: server.%d{yyyy-MM-dd}.%i.log + +![在这里插入图片描述](https://img-blog.csdnimg.cn/756bf00cf4f44ea286b6fac6f31ccf44.png) + +## 10、热部署 + + + org.springframework.boot + spring-boot-devtools + true + spring: + # 热部署范围配置 + devtools: + restart: + # 设置不参与热部署的文件和文件夹（即修改后不重启） + exclude: static/**,public/**,config/application.yml + #是否可用 + enabled: false + +如果配置文件比较多的时候找热部署对应配置比较麻烦，可以在`springboot`启动类的main方法中设置，此处设置的优先级将比配置文件高，一定会生效。 + +System.setProperty("spring.devtools.restart.enabled", "false"); +## 11、属性绑定 + +1. 先在要配置的类上面加@Component注解将该类交由spring容器管理； +2. `@ConfigurationProperties(prefix="xxx")`，xxx跟application.yml配置文件中的属性对应； +3. 如果多个配置类想统一管理也可以通过`@EnableConfigurationProperties({xxx.class, yyy.class})`的方式完成配置，不过该注解会与@Component配置发生冲突，二选一即可； +4. 第三方类对象想通过配置进行属性注入，可以通过创建一个方法，在方法体上加@Bean和`@ConfigurationProperties(prefix="xxx")`注解，然后方法返回这个第三方对象的方式。 +5. 使用`@ConfigurationProperties(prefix="xxx")`注解后idea工具会报一个警告Spring Boot Configuration Annotation Processor not configured + +@ConfigurationProperties(prefix="xxx") +@Data +public class ServerConfig { + private String inAddress; + private int port; + private long timeout; +} + +`@ConfigurationProperties`绑定属性支持属性名宽松绑定，又叫松散绑定。 + +比如要将`ServerConfig.class`作为配置类，并通过配置文件`application.yml`绑定属性 + +ServerConfig.class serverConfig: + # ipAddress: 192.168.0.1 # 驼峰模式 + # ipaddress: 192.168.0.1 + # IPADDRESS: 192.168.0.1 + ip-address: 192.168.0.1 # 主流配置方式，烤肉串模式 + # ip_address: 192.168.0.1 # 下划线模式 + # IP_ADDRESS: 192.168.0.1 # 常量模式 + # ip_Add_rEss: 192.168.0.1 + # ipaddress: 192.168.0.1 + port: 8888 + timeout: -1 + +以ipAddress属性为例，上面的多种配置方式皆可生效，这就是松散绑定。而@Value不支持松散绑定，必须一一对应。 + +`@ConfigurationProperties(prefix="serverconfig")`中的prefix的值为serverconfig或者server-config，如果是serverConfig就会报错，这与松散绑定的前缀命名规范有关：仅能使用纯小写字母、数字、中划线作为合法的字符 + +## 12、常用计量单位应用 + +//@Component +@ConfigurationProperties(prefix = "server-config") +@Data +public class ServerConfig { + private String ipAddress; + private int port; + @DurationUnit(ChronoUnit.MINUTES) + private Duration timeout; + + @DataSizeUnit(DataUnit.MEGABYTES) + private DataSize dataSize; +} + +引入`Bean`属性校验框架的步骤： + +1. 在`pom.xml`中添加`JSR303`规范和`hibernate`校验框架的依赖： + + + + javax.validation + validation-api + + + + org.hibernate.validator + hibernate-validator + + +1. 在要校验的类上加`@Validated`注解 + +2. 设置具体的校验规则，如：`@Max(value=8888, message="最大值不能超过8888")` + +@ConfigurationProperties(prefix = "server-config") +@Data +// 2.开启对当前bean的属性注入校验 +@Validated +public class ServerConfig { + private String ipAddress; + // 设置具体的规则 + @Max(value = 8888, message = "最大值不能超过8888") + @Min(value = 1000, message = "最小值不能低于1000") + private int port; + @DurationUnit(ChronoUnit.MINUTES) + private Duration timeout; + + @DataSizeUnit(DataUnit.MEGABYTES) + private DataSize dataSize; +} + +进制转换中的一些问题： + +如`application.yml`文件中对数据库有如下配置： + +datasource: + driverClassName: com.mysql.cj.jdbc.Driver123 + # 不加引号读取的时候默认解析为了8进制数，转成十进制就是87 + # 所以想让这里正确识别，需要加上引号 + # password: 0127 + password: "0127" +## 13、测试类 + +### 13.1、加载专用属性 + +@SpringBootTest注解中可以设置properties和args属性，这里的args属性的作用跟idea工具中自带的程序参数类似，只不过这里的配置是源码级别的，会随着源码的移动而跟随，而idea中的程序参数的配置会丢失。并且这里的args属性的配置的作用范围比较小，仅在当前测试类生效。 + +application.yml + +test: + prop: testValue // properties属性可以为当前测试用例添加临时的属性配置 +//@SpringBootTest(properties = {"test.prop=testValue1"}) +// args属性可以为当前测试用例添加临时的命令行参数 +//@SpringBootTest(args = {"--test.prop=testValue2"}) +// 优先级排序： args > properties > 配置文件 +@SpringBootTest(args = {"--test.prop=testValue2"}, properties = {"test.prop=testValue1"}) +class PropertiesAndArgsTest { + @Value("${test.prop}") + private String prop; + @Test + public void testProperties() { + System.out.println("prop = " + prop); + } +} +### 13.2、加载专用类 + +某些测试类中需要用到第三方的类，而其他测试类则不需要用到，这里可以在类上加载`@Import({xxx.class， yyy.class})` + +@RestController +@RequestMapping("/books") +public class BookController { + /*@GetMapping("/{id}") + public String getById(@PathVariable int id) { + System.out.println("id = " + id); + return "getById..."; + }*/ + + @GetMapping("/{id}") + public Book getById(@PathVariable int id) { + System.out.println("id = " + id); + Book book = new Book(); + book.setId(5); + book.setName("springboot"); + book.setType("springboot"); + book.setDescription("springboot"); + return book; + } +} + +相应测试类 + +@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT) +// 开启虚拟mvc调用 +@AutoConfigureMockMvc +public class WebTest { + @Test + public void testRandomPort() { + } + + @Test + public void testWeb(@Autowired MockMvc mvc) throws Exception { + // 创建虚拟请求，当前访问 /books + MockHttpServletRequestBuilder builder = MockMvcRequestBuilders.get("/books/5"); + mvc.perform(builder); + } + + @Test + public void testStatus(@Autowired MockMvc mvc) throws Exception { + MockHttpServletRequestBuilder builder = MockMvcRequestBuilders.get("/books1/6"); + ResultActions action = mvc.perform(builder); + // 设定预期值，与真实值进行比较，成功测试通过，失败测试不通过 + // 定义本次调用的预期值 + StatusResultMatchers srm = MockMvcResultMatchers.status(); + // 预计本次调用成功的状态码：200 + ResultMatcher ok = srm.isOk(); + // 添加预计值到本次调用过程中进行匹配 + action.andExpect(ok); + } + + @Test + public void testBody(@Autowired MockMvc mvc) throws Exception { + MockHttpServletRequestBuilder builder = MockMvcRequestBuilders.get("/books/6"); + ResultActions action = mvc.perform(builder); + // 设定预期值，与真实值进行比较，成功测试通过，失败测试不通过 + // 定义本次调用的预期值 + ContentResultMatchers crm = MockMvcResultMatchers.content(); + // 预计本次调用成功的状态码：200 + ResultMatcher rm = crm.string("getById..."); + // 添加预计值到本次调用过程中进行匹配 + action.andExpect(rm); + } + + @Test + public void testJson(@Autowired MockMvc mvc) throws Exception { + MockHttpServletRequestBuilder builder = MockMvcRequestBuilders.get("/books/7"); + ResultActions action = mvc.perform(builder); + // 设定预期值，与真实值进行比较，成功测试通过，失败测试不通过 + // 定义本次调用的预期值 + ContentResultMatchers jsonMatcher = MockMvcResultMatchers.content(); + ResultMatcher rm = jsonMatcher.json("{\"id\":5,\"name\":\"springboot\",\"type\":\"springboot\",\"description\":\"springboot1\"}"); + action.andExpect(rm); + } + + @Test + public void testContentType(@Autowired MockMvc mvc) throws Exception { + MockHttpServletRequestBuilder builder = MockMvcRequestBuilders.get("/books/7"); + ResultActions action = mvc.perform(builder); + // 设定预期值，与真实值进行比较，成功测试通过，失败测试不通过 + // 定义本次调用的预期值 + HeaderResultMatchers hrm = MockMvcResultMatchers.header(); + ResultMatcher rm = hrm.string("Content-Type", "application/json"); + action.andExpect(rm); + } + + @Test + // 完整测试 + public void testGetById(@Autowired MockMvc mvc) throws Exception { + MockHttpServletRequestBuilder builder = MockMvcRequestBuilders.get("/books/8"); + ResultActions action = mvc.perform(builder); + + // 1、比较状态码 + StatusResultMatchers statusResultMatchers = MockMvcResultMatchers.status(); + ResultMatcher statusResultMatcher = statusResultMatchers.isOk(); + action.andExpect(statusResultMatcher); + + // 2、比较返回值类型 + HeaderResultMatchers headerResultMatchers = MockMvcResultMatchers.header(); + ResultMatcher headerResultMatcher = headerResultMatchers.string("Content-Type", "application/json"); + action.andExpect(headerResultMatcher); + + /// 3、比较json返回值 + ContentResultMatchers contentResultMatchers = MockMvcResultMatchers.content(); + ResultMatcher jsonResultMatcher = contentResultMatchers.json("{\"id\":5,\"name\":\"springboot\",\"type\":\"springboot\",\"description\":\"springboot\"}"); + action.andExpect(jsonResultMatcher); + } +} +### 13.3、业务层测试事务回滚 + +* 为测试用例添加事务，SpringBoot会对测试用例对应的事务提交操作进行回滚 + + @SpringBootTest + @Transactional public class DaoTest { + @Autowired + private BookService bookService; } +* l如果想在测试用例中提交事务，可以通过@Rollback注解设置 + + @SpringBootTest + @Transactional + @Rollback(false) + public class DaoTest { + } + +### 13.4、测试用例数据设定 + +* 测试用例数据通常采用随机值进行测试，使用SpringBoot提供的随机数为其赋值 + +testcast: + book: + id: ${random.int} # 随机整数 + id2: ${random.int(10)} # 10以内随机数 + type: ${random.int(10,20)} # 10到20随机数 + uuid: ${random.uuid} # 随机uuid + name: ${random.value} # 随机字符串,MD5字符串,32位 + publishTime: ${random.long} # 随机整数(long范围) u${random.int}表示随机整数 + +u${random.int(10)}表示10以内的随机数 + +u${random.int(10,20)}表示10到20的随机数 + +u其中()可以是任意字符，例如[]，!!均可 +## 14、数据层解决方案 + +### 14.1、SQL + +现有数据层解决方案技术选型 + +Druid + MyBatis-Plus + MySQL + +* 数据源：DruidDataSource +* 持久化技术：MyBatis-Plus / MyBatis +* 数据库：MySQL + +格式一： + +spring: + datasource: + driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC + username: root + password: root + +格式二： + +spring: + datasource: + druid: + driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC + username: root + password: root + +* SpringBoot提供了3种内嵌的数据源对象供开发者选择 + * HikariCP + * Tomcat提供DataSource + * Commons DBCP + +spring: + datasource: + driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC + username: root + password: root spring: + datasource: + druid: + driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC + username: root + password: root + +* SpringBoot提供了3种内嵌的数据源对象供开发者选择 + + * HikariCP：默认内置数据源对象 + + * Tomcat提供DataSource：HikariCP不可用的情况下，且在web环境中，将使用tomcat服务器配置的数据源对象 + + * Commons DBCP：Hikari不可用，tomcat数据源也不可用，将使用dbcp数据源 + +* 通用配置无法设置具体的数据源配置信息，仅提供基本的连接相关配置，如需配置，在下一级配置中设置具体设定 + +spring: + datasource: + driver-class-name: com.mysql.cj.jdbc.Driver + url: jdbc:mysql://localhost:3306/ssm_db + username: root + password: root + hikari: + maximum-pool-size: 50 + +* 内置持久化解决方案——JdbcTemplate + +@SpringBootTest +class Springboot15SqlApplicationTests { + @Autowired + private JdbcTemplate jdbcTemplate; + @Test + void testJdbc(){ + String sql = "select * from tbl_book where id = 1"; + List query = jdbcTemplate.query(sql, new RowMapper() { + @Override + public Book mapRow(ResultSet rs, int rowNum) throws SQLException { + Book temp = new Book(); + temp.setId(rs.getInt("id")); + temp.setName(rs.getString("name")); + temp.setType(rs.getString("type")); + temp.setDescription(rs.getString("description")); + return temp; + } + }); + System.out.println(query); + } +} + org.springframework.boot + spring-boot-starter-jdbc + spring: + jdbc: + template: + query-timeout: -1 # 查询超时时间 + max-rows: 500 # 最大行数 + fetch-size: -1 # 缓存行数 + +* SpringBoot提供了3种内嵌数据库供开发者选择，提高开发测试效率 + + * H2 + * HSQL + * Derby +* 导入H2相关坐标 + + + org.springframework.boot + spring-boot-starter-data-jpa + + + com.h2database + h2 + runtime + +* 设置当前项目为web工程，并配置H2管理控制台参数 + +server: + port: 80 +spring: + h2: + console: + path: /h2 + enabled: true + +访问用户名sa，默认密码123456 + +操作数据库（创建表） + +create table tbl_book (id int,name varchar,type varchar,description varchar) #设置访问数据源 +server: + port: 80 +spring: + datasource: + driver-class-name: org.h2.Driver + url: jdbc:h2:~/test + username: sa + password: 123456 +h2: + console: + path: /h2 + enabled: true + +H2数据库控制台仅用于开发阶段，线上项目请务必关闭控制台功能 + +server: + port: 80 +spring: + h2: + console: + path: /h2 + enabled: false + +SpringBoot可以根据url地址自动识别数据库种类，在保障驱动类存在的情况下，可以省略配置 + +server: + port: 80 +spring: + datasource: +# driver-class-name: org.h2.Driver + url: jdbc:h2:~/test + username: sa + password: 123456 + h2: + console: + path: /h2 + enabled: true + +![在这里插入图片描述](https://img-blog.csdnimg.cn/cb7f9780f7884e9bb8b993ee2363dd6e.png) + +### 14.2、MongoDB + +MongoDB是一个开源、高性能、无模式的文档型数据库。NoSQL数据库产品中的一种，是最像关系型数据库的非关系型数据库 +![在这里插入图片描述](https://img-blog.csdnimg.cn/bc3313adaf3a471da66e8a9a062f552b.png) + +#### 14.2.1、MongoDB的使用 + +* Windows版Mongo下载 + +https://www.mongodb.com/try/download + +* Windows版Mongo安装 + +解压缩后设置数据目录 + +* Windows版Mongo启动 + +服务端启动 + +在bin目录下 + +`mongod --dbpath=..\data\db` + +客户端启动 + +`mongo --host=127.0.0.1 --port=27017` + +#### 14.2.2、MongoDB可视化客户端 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/48f4a3f143be40cbaf09e018df91dc5e.png) + +* 新增 + + `db.集合名称.insert/save/insertOne(文档)` + +* 修改 + + `db.集合名称.remove(条件)` + +* 删除 + + `db.集合名称.update(条件，{操作种类:{文档}})` + ![在这里插入图片描述](https://img-blog.csdnimg.cn/349eb759436043b88ec23d8541c41340.png) + ![在这里插入图片描述](https://img-blog.csdnimg.cn/f5140aed83ee407db4a4652f81fe7d9a.png) + +#### 14.2.3、Springboot集成MongoDB + +导入MongoDB驱动 + + + org.springframework.boot + spring-boot-starter-data-mongodb + + +配置客户端 + +spring: + data: + mongodb: + uri: mongodb://localhost/itheima + +客户端读写MongoDB + +@Test +void testSave(@Autowired MongoTemplate mongoTemplate){ + Book book = new Book(); + book.setId(1); + book.setType("springboot"); + book.setName("springboot"); + book.setDescription("springboot"); + mongoTemplate.save(book); +} +@Test +void testFind(@Autowired MongoTemplate mongoTemplate){ + List all = mongoTemplate.findAll(Book.class); + System.out.println(all); +} +### 14.3、ElasticSearch（ES） + +Elasticsearch是一个分布式全文搜索引擎 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/a5bb0c141ef24ed8bfedf270201dae1e.png) + +![在这里插入图片描述](https://img-blog.csdnimg.cn/a17cd8d3332d42c4a1161c8541f1fbbb.png) + +#### 14.3.1、ES下载 + +* Windows版ES下载 + +[https://](https://www.elastic.co/cn/downloads/elasticsearch)[www.elastic.co/cn/downloads/elasticsearch](https://www.elastic.co/cn/downloads/elasticsearch) + +* Windows版ES安装与启动 + +运行：`elasticsearch.bat` + +#### 14.3.2、ES索引、分词器 + +* 创建/查询/删除索引 + +put：`http://localhost:9200/books` + +get：`http://localhost:9200/books` + +delete：`http://localhost:9200/books` + +* IK分词器 + + 下载：https://github.com/medcl/elasticsearch-analysis-ik/releases + +* 创建索引并指定规则 + +{ + "mappings":{ + "properties":{ + "id":{ + "type":"keyword" + }, + "name":{ + "type":"text", "analyzer":"ik_max_word", "copy_to":"all" + }, + "type":{ + "type":"keyword" + }, + "description":{ + "type":"text", "analyzer":"ik_max_word", "copy_to":"all" + }, + "all":{ + "type":"text", "analyzer":"ik_max_word" + } + } + } +} +#### 14.3.3、文档操作（增删改查） + +* 创建文档 + + post：`http://localhost:9200/books/_doc`（使用系统生成的id） + + post：`http://localhost:9200/books/_create/1`（使用指定id） + + post：`http://localhost:9200/books/_doc/1`（使用指定id，不存在创建，存在更新，版本递增） + + { + "name":"springboot", + "type":"springboot", + "description":"springboot" + } +* 查询文档 + + get：`http://localhost:9200/books/_doc/1` + + get：`http://localhost:9200/books/_search` + +* 条件查询 + + get：`http://localhost:9200/books/_search?q=name:springboot` + +* 删除文档 + + delete：`http://localhost:9200/books/_doc/1` + +* 修改文档（全量修改） + + put：`http://localhost:9200/books/_doc/1` + + { + "name":"springboot", + "type":"springboot", + "description":"springboot" + } +* 修改文档（部分修改） + + post：`http://localhost:9200/books/_update/1` + + { + "doc":{ + "name":"springboot" + } + } + +#### 14.3.4、Springboot集成ES + +* 导入坐标 + + + org.springframework.boot + spring-boot-starter-data-elasticsearch + +* 配置 + + spring: + elasticsearch: + rest: + uris: http://localhost:9200 +* 客户端 + + @SpringBootTest + class Springboot18EsApplicationTests { + @Autowired + private ElasticsearchRestTemplate template; + } +* SpringBoot平台并没有跟随ES的更新速度进行同步更新，ES提供了High Level Client操作ES + + 导入坐标 + + + org.elasticsearch.client + elasticsearch-rest-high-level-client + + + 无需配置 + +* 客户端 + + @Test + void test() throws IOException { + HttpHost host = HttpHost.create("http://localhost:9200"); + RestClientBuilder builder = RestClient.builder(host); + RestHighLevelClient client = new RestHighLevelClient(builder); + //客户端操作 + CreateIndexRequest request = new CreateIndexRequest("books"); + //获取操作索引的客户端对象，调用创建索引操作 + client.indices().create(request, RequestOptions.DEFAULT); + //关闭客户端 + client.close(); + } +* 客户端改进 + + @SpringBootTest + class Springboot18EsApplicationTests { + @Autowired + private BookDao bookDao; + @Autowired + RestHighLevelClient client; + @BeforeEach + void setUp() { + this.client = new RestHighLevelClient(RestClient.builder(HttpHost.create("http://localhost:9200"))); + } + @AfterEach + void tearDown() throws IOException { + this.client.close(); + } + @Test + void test() throws IOException { + //客户端操作 + CreateIndexRequest request = new CreateIndexRequest("books"); + //获取操作索引的客户端对象，调用创建索引操作 + client.indices().create(request, RequestOptions.DEFAULT); + } + } + +#### 14.3.5、索引 + +* 创建索引 + + //创建索引 + @Test + void testCreateIndexByIK() throws IOException { + HttpHost host = HttpHost.create("http://localhost:9200"); + RestClientBuilder builder = RestClient.builder(host); + RestHighLevelClient client = new RestHighLevelClient(builder); + //客户端操作 + CreateIndexRequest request = new CreateIndexRequest("books"); + //设置要执行操作 + String json = ""; + //设置请求参数，参数类型json数据 + request.source(json,XContentType.JSON); + //获取操作索引的客户端对象，调用创建索引操作 + client.indices().create(request, RequestOptions.DEFAULT); + //关闭客户端 + client.close(); + } String json = "{\n" + + " \"mappings\":{\n" + + " \"properties\":{\n" + + " \"id\":{\n" + + " \"type\":\"keyword\"\n" + + " },\n" + + " \"name\":{\n" + + " \"type\":\"text\",\n" + + " \"analyzer\":\"ik_max_word\",\n" + + " \"copy_to\":\"all\"\n" + + " },\n" + + " \"type\":{\n" + + " \"type\":\"keyword\"\n" + + " },\n" + + " \"description\":{\n" + + " \"type\":\"text\",\n" + + " \"analyzer\":\"ik_max_word\",\n" + + " \"copy_to\":\"all\"\n" + + " },\n" + + " \"all\":{\n" + + " \"type\":\"text\",\n" + + " \"analyzer\":\"ik_max_word\"\n" + + " }\n" + + " }\n" + + " }\n" + + "}"; +* 添加文档 + + //添加文档 + @Test + void testCreateDoc() throws IOException { + Book book = bookDao.selectById(1); + IndexRequest request = new IndexRequest("books").id(book.getId().toString()); + String json = JSON.toJSONString(book); + request.source(json,XContentType.JSON); + client.index(request, RequestOptions.DEFAULT); + } +* 批量添加文档 + + //批量添加文档 + @Test + void testCreateDocAll() throws IOException { + List bookList = bookDao.selectList(null); + BulkRequest bulk = new BulkRequest(); + for (Book book : bookList) { + IndexRequest request = new IndexRequest("books").id(book.getId().toString()); + String json = JSON.toJSONString(book); + request.source(json,XContentType.JSON); + bulk.add(request); + } + client.bulk(bulk,RequestOptions.DEFAULT); + } +* 按id查询文档 + + @Test + void testGet() throws IOException { + GetRequest request = new GetRequest("books","1"); + GetResponse response = client.get(request, RequestOptions.DEFAULT); + String json = response.getSourceAsString(); + System.out.println(json); + } +* 按条件查询文档 + +@Test +void testSearch() throws IOException { + SearchRequest request = new SearchRequest("books"); + SearchSourceBuilder builder = new SearchSourceBuilder(); + builder.query(QueryBuilders.termQuery("all",“java")); + request.source(builder); + SearchResponse response = client.search(request, RequestOptions.DEFAULT); + SearchHits hits = response.getHits(); + for (SearchHit hit : hits) { + String source = hit.getSourceAsString(); + Book book = JSON.parseObject(source, Book.class); + System.out.println(book); + } +} +## 15、缓存 + +### 15.1、缓存简介 + +缓存是一种介于数据永久存储介质与数据应用之间的数据临时存储介质 +![在这里插入图片描述](https://img-blog.csdnimg.cn/be3b3d385ea7423cb66544139b28591d.png) + +* 缓存是一种介于数据永久存储介质与数据应用之间的数据临时存储介质 + +* 使用缓存可以有效的减少低速数据读取过程的次数（例如磁盘IO），提高系统性能 + +* 缓存不仅可以用于提高永久性存储介质的数据读取效率，还可以提供临时的数据存储空间 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/340efee416e64d83957abf3c421c3575.png) + +* SpringBoot提供了缓存技术，方便缓存使用 + +### 15.2、缓存使用 + +* 启用缓存 + +* 设置进入缓存的数据 + +* 设置读取缓存的数据 + +* 导入缓存技术对应的starter + + + org.springframework.boot + spring-boot-starter-cache + +* 启用缓存 + + @SpringBootApplication + @EnableCaching + public class Springboot19CacheApplication { + public static void main(String[] args) { + SpringApplication.run(Springboot19CacheApplication.class, args); + } + } +* 设置当前操作的结果数据进入缓存 + +@Cacheable(value="cacheSpace",key="#id") +public Book getById(Integer id) { + return bookDao.selectById(id); +} +### 15.3、其他缓存 + +* SpringBoot提供的缓存技术除了提供默认的缓存方案，还可以对其他缓存技术进行整合，统一接口，方便缓存技术的开发与管理 + * Generic + * JCache + * **Ehcache** + * Hazelcast + * Infinispan + * Couchbase + * **Redis** + * Caffeine + * Simple（默认） + * **memcached** + * jetcache（阿里) + +### 15.4、缓存使用案例——手机验证码 + +* 需求 + + * 输入手机号获取验证码，组织文档以短信形式发送给用户（页面模拟） + + * 输入手机号和验证码验证结果 + +* 需求分析 + + * 提供controller，传入手机号，业务层通过手机号计算出独有的6位验证码数据，存入缓存后返回此数据 + + * 提供controller，传入手机号与验证码，业务层通过手机号从缓存中读取验证码与输入验证码进行比对，返回比对结果 + +#### 15.4.1、Cache + +* 开启缓存 + + @SpringBootApplication + @EnableCaching + public class Springboot19CacheApplication { + public static void main(String[] args) { + SpringApplication.run(Springboot19CacheApplication.class, args); + } + } +* 业务层接口 + + public interface SMSCodeService { + /** + * 传入手机号获取验证码，存入缓存 + * @param tele + * @return + */ + String sendCodeToSMS(String tele); + + /** + * 传入手机号与验证码，校验匹配是否成功 + * @param smsCode + * @return + */ + boolean checkCode(SMSCode smsCode); + } +* 业务层设置获取验证码操作，并存储缓存，手机号为key，验证码为value + + @Autowired + private CodeUtils codeUtils; + @CachePut(value = "smsCode",key="#tele") + public String sendCodeToSMS(String tele) { + String code = codeUtils.generator(tele); + return code; + } +* 业务层设置校验验证码操作，校验码通过缓存读取，返回校验结果 + + @Autowired + private CodeUtils codeUtils; + public boolean checkCode(SMSCode smsCode) { + //取出内存中的验证码与传递过来的验证码比对，如果相同，返回true + String code = smsCode.getCode(); + String cacheCode = codeUtils.get(smsCode.getTele()); + return code.equals(cacheCode); + } @Component + public class CodeUtils { + @Cacheable(value = "smsCode",key="#tele") + public String get(String tele){ + return null; + } + } + +#### 15.4.2、Ehcache + +* 加入Ehcache坐标（缓存供应商实现） + + + net.sf.ehcache + ehcache + +* 缓存设定为使用Ehcache + + spring: + cache: + type: ehcache + ehcache: + config: ehcache.xml +* 提供ehcache配置文件ehcache.xml + + + + + + + + + + + + + + + + +#### 15.4.3、Redis + +* 加入Redis坐标（缓存供应商实现） + + + org.springframework.boot + spring-boot-starter-data-redis + + +* 配置Redis服务器，缓存设定为使用Redis + + spring: + redis: + host: localhost + port: 6379 + cache: + type: redis +* 设置Redis相关配置 + + spring: + redis: + host: localhost + port: 6379 + cache: + type: redis + redis: + use-key-prefix: true # 是否使用前缀名（系统定义前缀名） + key-prefix: sms_ # 追加自定义前缀名 + time-to-live: 10s # 有效时长 + cache-null-values: false # 是否允许存储空值 + +#### 15.4.4、memcached + +* 下载memcached + +* 地址：https://www.runoob.com/memcached/window-install-memcached.html + +* 安装memcached + + * 使用管理员身份运行cmd指令 + + * 安装 + + `memcached.exe -d install` + +* 运行 + + * 启动服务 + + `memcached.exe -d start` + + * 定制服务 + + `memcached.exe -d stop` + +* memcached客户端选择 + + * Memcached Client for Java：最早期客户端，稳定可靠，用户群广 + * SpyMemcached：效率更高 + * Xmemcached：并发处理更好 +* SpringBoot未提供对memcached的整合，需要使用硬编码方式实现客户端初始化管理 + +* 加入Xmemcached坐标（缓存供应商实现） + + + com.googlecode.xmemcached + xmemcached + 2.4.7 + +* 配置memcached服务器必要属性 + + memcached: + # memcached服务器地址 + servers: localhost:11211 + # 连接池的数量 + poolSize: 10 + # 设置默认操作超时 + opTimeout: 3000 +* 创建读取属性配置信息类，加载配置 + + @Component + @ConfigurationProperties(prefix = "memcached") + @Data + public class XMemcachedProperties { + private String servers; + private Integer poolSize; + private Long opTimeout; + } +* 创建客户端配置类 + + @Configuration + public class XMemcachedConfig { + @Autowired + private XMemcachedProperties xMemcachedProperties; + @Bean + public MemcachedClient getMemcachedClinet() throws IOException { + MemcachedClientBuilder builder = new XMemcachedClientBuilder(xMemcachedProperties.getServers()); + MemcachedClient memcachedClient = builder.build(); + return memcachedClient; + } + } +* 配置memcached属性 + + @Service + public class SMSCodeServiceMemcacheImpl implements SMSCodeService { + @Autowired + private CodeUtils codeUtils; + @Autowired + private MemcachedClient memcachedClient; + @Override + public String sendCodeToSMS(String tele) { + String code = this.codeUtils.generator(tele); + //将数据加入memcache + try { + memcachedClient.set(tele,0,code); // key,timeout,value + } catch (Exception e) { + e.printStackTrace(); + } + return code; + } + } @Service + public class SMSCodeServiceMemcacheImpl implements SMSCodeService { + @Autowired + private CodeUtils codeUtils; + @Autowired + private MemcachedClient memcachedClient; + @Override + public boolean checkCode(CodeMsg codeMsg) { + String value = null; + try { + value = memcachedClient.get(codeMsg.getTele()).toString(); + } catch (Exception e) { + e.printStackTrace(); + } + return codeMsg.getCode().equals(value); + } + } + +#### 15.4.5、jetcache + +* jetCache对SpringCache进行了封装，在原有功能基础上实现了多级缓存、缓存统计、自动刷新、异步调用、数据报表等功能 + +* jetCache设定了本地缓存与远程缓存的多级缓存解决方案 + + * 本地缓存（local） + + * LinkedHashMap + * Caffeine + * 远程缓存（remote） + + * Redis + * Tair +* 加入jetcache坐标 + + + com.alicp.jetcache + jetcache-starter-redis + 2.6.2 + +* 配置**远程**缓存必要属性 + + jetcache: + remote: + default: + type: redis + host: localhost + port: 6379 + poolConfig: + maxTotal: 50 jetcache: + remote: + default: + type: redis + host: localhost + port: 6379 + poolConfig: + maxTotal: 50 + sms: + type: redis + host: localhost + port: 6379 + poolConfig: + maxTotal: 50 +* 配置**本地**缓存必要属性 + + jetcache: + local: + default: + type: linkedhashmap + keyConvertor: fastjson +* 配置范例 + + jetcache: + statIntervalMinutes: 15 + areaInCacheName: false + local: + default: + type: linkedhashmap + keyConvertor: fastjson + limit: 100 + remote: + default: + host: localhost + port: 6379 + type: redis + keyConvertor: fastjson + valueEncoder: java + valueDecoder: java + poolConfig: + minIdle: 5 + maxIdle: 20 + maxTotal: 50 +* 配置属性说明 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/bb8230091ee84b91828bf74555e8d64b.png) + +* 开启jetcache注解支持 + + @SpringBootApplication + @EnableCreateCacheAnnotation + public class Springboot19CacheApplication { + public static void main(String[] args) { + SpringApplication.run(Springboot19CacheApplication.class, args); + } + } +* 声明缓存对象 + + @Service + public class SMSCodeServiceImpl implements SMSCodeService { + @Autowired + private CodeUtils codeUtils; + @CreateCache(name = "smsCache", expire = 3600) + private Cache jetSMSCache; + } +* 操作缓存 + + @Service + public class SMSCodeServiceImpl implements SMSCodeService { + @Override + public String sendCodeToSMS(String tele) { + String code = this.codeUtils.generator(tele); + jetSMSCache.put(tele,code); + return code; + } + @Override + public boolean checkCode(CodeMsg codeMsg) { + String value = jetSMSCache.get(codeMsg.getTele()); + return codeMsg.getCode().equals(value); + } + } +* 启用方法注解 + + @SpringBootApplication + @EnableCreateCacheAnnotation + @EnableMethodCache(basePackages = "com.itheima") + public class Springboot20JetCacheApplication { + public static void main(String[] args) { + SpringApplication.run(Springboot20JetCacheApplication.class, args); + } + } +* 使用方法注解操作缓存 + + @Service + public class BookServiceImpl implements BookService { + @Autowired + private BookDao bookDao; + @Cached(name = "smsCache_", key = "#id", expire = 3600) + @CacheRefresh(refresh = 10,timeUnit = TimeUnit.SECONDS) + public Book getById(Integer id) { + return bookDao.selectById(id); + } + } @Service + public class BookServiceImpl implements BookService { + + @CacheUpdate(name = "smsCache_", key = "#book.id", value = "#book") + public boolean update(Book book) { + return bookDao.updateById(book) > 0; + } + + @CacheInvalidate(name = "smsCache_", key = "#id") + public boolean delete(Integer id) { + return bookDao.deleteById(id) > 0; + } + } +* 缓存对象必须保障可序列化 + + @Data + public class Book implements Serializable { + } jetcache: + remote: + default: + type: redis + keyConvertor: fastjson + valueEncoder: java + valueDecoder: java +* 查看缓存统计报告 + + jetcache: + statIntervalMinutes: 15 + +#### 15.4.6、j2cache + +* j2cache是一个缓存整合框架，可以提供缓存的整合方案，使各种缓存搭配使用，自身不提供缓存功能 + +* 基于 ehcache + redis 进行整合 + +* 加入j2cache坐标，加入整合缓存的坐标 + + + net.oschina.j2cache + j2cache-spring-boot2-starter + 2.8.0-release + + + net.oschina.j2cache + j2cache-core + 2.8.4-release + + + net.sf.ehcache + ehcache + +* 配置使用j2cache（application.yml） + + j2cache: + config-location: j2cache.properties +* 配置一级缓存与二级缓存以及一级缓存数据到二级缓存的发送方式（j2cache.properties） + + # 配置1级缓存 + j2cache.L1.provider_class = ehcache + ehcache.configXml = ehcache.xml + + # 配置1级缓存数据到2级缓存的广播方式：可以使用redis提供的消息订阅模式，也可以使用jgroups多播实现 + j2cache.broadcast = net.oschina.j2cache.cache.support.redis.SpringRedisPubSubPolicy + + # 配置2级缓存 + j2cache.L2.provider_class = net.oschina.j2cache.cache.support.redis.SpringRedisProvider + j2cache.L2.config_section = redis + redis.hosts = localhost:6379 +* 设置使用缓存 + + @Service + public class SMSCodeServiceImpl implements SMSCodeService { + @Autowired + private CodeUtils codeUtils; + @Autowired + private CacheChannel cacheChannel; + } @Service + public class SMSCodeServiceImpl implements SMSCodeService { + @Override + public String sendCodeToSMS(String tele) { + String code = codeUtils.generator(tele); + cacheChannel.set("sms",tele,code); + return code; + } + @Override + public boolean checkCode(SMSCode smsCode) { + String code = cacheChannel.get("sms",smsCode.getTele()).asString(); + return smsCode.getCode().equals(code); + } + } + +## 16、定时 + +任务 + +* 定时任务是企业级应用中的常见操作 + + * 年度报表 + * 缓存统计报告 + * … … +* 市面上流行的定时任务技术 + + * Quartz + * Spring Task + +### 16.1、SpringBoot整合Quartz + +* 相关概念 + + * 工作（Job）：用于定义具体执行的工作 + * 工作明细（JobDetail）：用于描述定时工作相关的信息 + * 触发器（Trigger）：用于描述触发工作的规则，通常使用cron表达式定义调度规则 + * 调度器（Scheduler）：描述了工作明细与触发器的对应关系 +* 导入SpringBoot整合quartz的坐标 + + + org.springframework.boot + spring-boot-starter-quartz + +* 定义具体要执行的任务，继承QuartzJobBean + + public class QuartzTaskBean extends QuartzJobBean { + @Override + protected void executeInternal(JobExecutionContext context) throws JobExecutionException { + System.out.println(“quartz job run... "); + } + } +* 定义工作明细与触发器，并绑定对应关系 + + @Configuration + public class QuartzConfig { + @Bean + public JobDetail printJobDetail(){ + return JobBuilder.newJob(QuartzTaskBean.class).storeDurably().build(); + } + @Bean + public Trigger printJobTrigger() { + CronScheduleBuilder cronScheduleBuilder = CronScheduleBuilder.cronSchedule("0/3 * * * * ?"); + return TriggerBuilder.newTrigger().forJob(printJobDetail()) + .withSchedule(cronScheduleBuilder).build(); + } + } + +### 16.2、Spring Task + +* 开启定时任务功能 + + @SpringBootApplication + @EnableScheduling + public class Springboot22TaskApplication { + public static void main(String[] args) { + SpringApplication.run(Springboot22TaskApplication.class, args); + } + } +* 设置定时执行的任务，并设定执行周期 + + @Component + public class ScheduledBean { + @Scheduled(cron = "0/5 * * * * ?") + public void printLog(){ + System.out.println(Thread.currentThread().getName()+":run..."); + } + } +* 定时任务相关配置 + + spring: + task: + scheduling: + # 任务调度线程池大小 默认 1 + pool: + size: 1 + # 调度线程名称前缀 默认 scheduling- + thread-name-prefix: ssm_ + shutdown: + # 线程池关闭时等待所有任务完成 + await-termination: false + # 调度线程关闭前最大等待时间，确保最后一定关闭 + await-termination-period: 10s + +### 16.3、SpringBoot整合JavaMail + +* SMTP（Simple Mail Transfer Protocol）：简单邮件传输协议，用于**发送**电子邮件的传输协议 + +* POP3（Post Office Protocol - Version 3）：用于**接收**电子邮件的标准协议 + +* IMAP（Internet Mail Access Protocol）：互联网消息协议，是POP3的替代协议 + +* 导入SpringBoot整合JavaMail的坐标 + + + org.springframework.boot + spring-boot-starter-mail + +* 配置JavaMail + + spring: + mail: + host: smtp.qq.com + username: *********@qq.com + password: ********* + +![在这里插入图片描述](https://img-blog.csdnimg.cn/8c4baf0029074afaaca6ff4c670edd56.png) + +* 开启定时任务功能 + + @Service + public class SendMailServiceImpl implements SendMailService { + private String from = “********@qq.com"; // 发送人 + private String to = "********@126.com"; // 接收人 + private String subject = "测试邮件"; // 邮件主题 + private String text = "测试邮件正文"; // 邮件内容 + } +* 开启定时任务功能 + + @Service + public class SendMailServiceImpl implements SendMailService { + @Autowired + private JavaMailSender javaMailSender; + @Override + public void sendMail() { + SimpleMailMessage mailMessage = new SimpleMailMessage(); + mailMessage.setFrom(from); + mailMessage.setTo(to); + mailMessage.setSubject(subject); + mailMessage.setText(text); + javaMailSender.send(mailMessage); + } + } +* 附件与HTML文本支持 + + private String text = "传智教育"; + @Override + public void sendMail() { + try { + MimeMessage mimeMessage = javaMailSender.createMimeMessage(); + MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMessage,true); + mimeMessageHelper.setFrom(from); + mimeMessageHelper.setTo(to); + mimeMessageHelper.setSubject(subject); + mimeMessageHelper.setText(text,true); + File file = new File("logo.png"); + mimeMessageHelper.addAttachment("美图.png",file); + javaMailSender.send(mimeMessage); + } catch (Exception e) { + e.printStackTrace(); + } + } + +## 17、消息 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/fbb603a59b2b417fab3a7e26c48b2987.png) + +* 企业级应用中广泛使用的三种异步消息传递技术 + * JMS + * AMQP + * MQTT + +### 17.1、JMS + +* JMS（Java Message Service）：一个规范，等同于JDBC规范，提供了与消息服务相关的API接口 + +* JMS消息模型 + + * peer-2-peer：点对点模型，消息发送到一个队列中，队列保存消息。队列的消息只能被一个消费者消费，或超时 + * **pub**lish-**sub**scribe：发布订阅模型，消息可以被多个消费者消费，生产者和消费者完全独立，不需要感知对方的存在 +* JMS消息种类 + + * TextMessage + * MapMessage + * **BytesMessage** + * StreamMessage + * ObjectMessage + * Message （只有消息头和属性） +* JMS实现：ActiveMQ、Redis、HornetMQ、RabbitMQ、RocketMQ（没有完全遵守JMS规范 + +### 17.2、AMQP + +* AMQP（advanced message queuing protocol）：一种协议（高级消息队列协议，也是消息代理规范），规范了网络交换的数据格式，兼容JMS + +* 优点：具有跨平台性，服务器供应商，生产者，消费者可以使用不同的语言来实现 + +* AMQP消息模型 + + * direct exchange + * fanout exchange + * topic exchange + * headers exchange + * system exchange +* AMQP消息种类：byte[] + +* AMQP实现：RabbitMQ、StormMQ、RocketMQ + +### 17.3、MQTT + +* MQTT（Message Queueing Telemetry Transport）消息队列遥测传输，专为小设备设计，是物联网（IOT）生态系统中主要成分之一 + +### 17.4、Kafka + +* Kafka，一种高吞吐量的分布式发布订阅消息系统，提供实时消息功能。 + +### 17.5、消息案例 + +* 购物订单业务 + * 登录状态检测 + * 生成主单 + * 生成子单 + * 库存检测与变更 + * 积分变更 + * 支付 + * 短信通知（异步） + * 购物车维护 + * 运单信息初始化 + * 商品库存维护 + * 会员维护 + * … + +### 17.6、ActiveMQ + +* 下载地址：[https://activemq.apache.org/components/classic/download](https://activemq.apache.org/components/classic/download/)[/](https://activemq.apache.org/components/classic/download/) + +* 安装：解压缩 + +* 启动服务 + + `activemq.bat` + +* 访问服务器 + + `http://127.0.0.1:8161/` + + * 服务端口：61616，管理后台端口：8161 + * 用户名&密码：**admin** + +#### 17.6.1、SpringBoot整合ActiveMQ + +* 导入SpringBoot整合ActiveMQ坐标 + + + org.springframework.boot + spring-boot-starter-activemq + +* 配置ActiveMQ（采用默认配置） + + spring: + activemq: + broker-url: tcp://localhost:61616 + jms: + pub-sub-domain: true + template: + default-destination: itheima +* 生产与消费消息（使用默认消息存储队列） + + @Service + public class MessageServiceActivemqImpl implements MessageService { + @Autowired + private JmsMessagingTemplate jmsMessagingTemplate; + public void sendMessage(String id) { + System.out.println("使用Active将待发送短信的订单纳入处理队列，id："+id); + jmsMessagingTemplate.convertAndSend(id); + } + public String doMessage() { + return jmsMessagingTemplate.receiveAndConvert(String.class); + } + } +* 生产与消费消息（指定消息存储队列） + + @Service + public class MessageServiceActivemqImpl implements MessageService { + @Autowired + private JmsMessagingTemplate jmsMessagingTemplate; + + public void sendMessage(String id) { + System.out.println("使用Active将待发送短信的订单纳入处理队列，id："+id); + jmsMessagingTemplate.convertAndSend("order.sm.queue.id",id); + } + public String doMessage() { + return jmsMessagingTemplate.receiveAndConvert("order.sm.queue.id",String.class); + } + } +* 使用消息监听器对消息队列监听 + + @Component + public class MessageListener { + @JmsListener(destination = "order.sm.queue.id") + public void receive(String id){ + System.out.println("已完成短信发送业务，id："+id); + } + } +* 流程性业务消息消费完转入下一个消息队列 + + @Component + public class MessageListener { + @JmsListener(destination = "order.sm.queue.id") + @SendTo("order.other.queue.id") + public String receive(String id){ + System.out.println("已完成短信发送业务，id："+id); + return "new:"+id; + } + } + +### 17.7、RabbitMQ + +* RabbitMQ基于Erlang语言编写，需要安装Erlang + +* Erlang + + * 下载地址：[https](https://www.erlang.org/downloads)[😕/www.erlang.org/downloads](https://www.erlang.org/downloads) + * 安装：一键傻瓜式安装，安装完毕需要重启，需要依赖Windows组件 + * 环境变量配置 + * ERLANG_HOME + * PATH +* 下载地址：[https://](https://rabbitmq.com/install-windows.html)[rabbitmq.com/install-windows.html](https://rabbitmq.com/install-windows.html) + +* 安装：一键傻瓜式安装 + +* 启动服务 + + `rabbitmq-service.bat start` + +* 关闭服务 + + `rabbitmq-service.bat stop` + +* 查看服务状态 + + `rabbitmqctl status` + +* 服务管理可视化（插件形式） + +* 查看已安装的插件列表 + +* 开启服务管理插件 + + `rabbitmq-plugins.bat enable rabbitmq_management` + +* 访问服务器 + + `http://localhost:15672` + + * 服务端口：5672，管理后台端口：15672 + * 用户名&密码：**guest** + +#### 17.7.1、SpringBoot整合RabbitMQ + +* 导入SpringBoot整合RabbitMQ坐标 + + + org.springframework.boot + spring-boot-starter-amqp + +* 配置RabbitMQ （采用默认配置） + + spring: + rabbitmq: + host: localhost + port: 5672 +* 定义消息队列(direct) + + @Configuration + public class RabbitDirectConfig { + @Bean + public Queue queue(){ + return new Queue("simple_queue"); + } + } @Configuration + public class RabbitDirectConfig { + @Bean + public Queue queue(){ + // durable:是否持久化,默认false + // exclusive:是否当前连接专用，默认false，连接关闭后队列即被删除 + // autoDelete:是否自动删除，当生产者或消费者不再使用此队列，自动删除 + return new Queue("simple_queue",true,false,false); + } + } @Configuration + public class RabbitDirectConfig { + @Bean + public Queue directQueue(){ + return new Queue("direct_queue"); + } + @Bean + public Queue directQueue2(){ + return new Queue("direct_queue2"); + } + @Bean + public DirectExchange directExchange(){ + return new DirectExchange("directExchange"); + } + @Bean + public Binding bindingDirect(){ + return BindingBuilder.bind(directQueue()).to(directExchange()).with("direct"); + } + @Bean + public Binding bindingDirect2(){ + return BindingBuilder.bind(directQueue2()).to(directExchange()).with("direct2"); + } + } +* 生产与消费消息(direct) + + @Service + public class MessageServiceRabbitmqDirectImpl implements MessageService { + @Autowired + private AmqpTemplate amqpTemplate; + @Override + public void sendMessage(String id) { + System.out.println("使用Rabbitmq将待发送短信的订单纳入处理队列，id："+id); + amqpTemplate.convertAndSend("directExchange","direct",id); + } + } +* 使用消息监听器对消息队列监听(direct) + + @Component + public class RabbitMessageListener { + @RabbitListener(queues = "direct_queue") + public void receive(String id){ + System.out.println("已完成短信发送业务，id："+id); + } + } +* 使用多消息监听器对消息队列监听进行消息轮循处理(direct) + + @Component + public class RabbitMessageListener2 { + @RabbitListener(queues = "direct_queue") + public void receive(String id){ + System.out.println("已完成短信发送业务（two），id："+id); + } + } +* 定义消息队列(topic) + + @Configuration + public class RabbitTopicConfig { + @Bean + public Queue topicQueue(){ return new Queue("topic_queue"); } + @Bean + public Queue topicQueue2(){ return new Queue("topic_queue2"); } + @Bean + public TopicExchange topicExchange(){ + return new TopicExchange("topicExchange"); + } + @Bean + public Binding bindingTopic(){ + return BindingBuilder.bind(topicQueue()).to(topicExchange()).with("topic.*.*"); + } + @Bean + public Binding bindingTopic2(){ + return BindingBuilder.bind(topicQueue2()).to(topicExchange()).with("topic.#"); + } + } +* 绑定键匹配规则 + + * `*`(星号)： 用来表示一个单词 ，且该单词是必须出现的 + * `#`(井号)： 用来表示任意数量 + +![在这里插入图片描述](https://img-blog.csdnimg.cn/bcfc4cb557714c3da413337a052de3ff.png) + +* 生产与消费消息(topic) + + @Service + public class MessageServiceRabbitmqTopicmpl implements MessageService { + @Autowired + private AmqpTemplate amqpTemplate; + @Override + public void sendMessage(String id) { + System.out.println("使用Rabbitmq将待发送短信的订单纳入处理队列，id："+id); + amqpTemplate.convertAndSend("topicExchange","topic.order.id",id); + } + } +* 使用消息监听器对消息队列监听(topic) + + @Component + public class RabbitTopicMessageListener { + @RabbitListener(queues = "topic_queue") + public void receive(String id){ + System.out.println("已完成短信发送业务，id："+id); + } + @RabbitListener(queues = "topic_queue2") + public void receive2(String id){ + System.out.println("已完成短信发送业务(two)，id："+id); + } + } + +### 17.8、RocketMQ + +* 下载地址：[https://rocketmq.apache.org](https://rocketmq.apache.org/)[/](https://rocketmq.apache.org/) + +* 安装：解压缩 + + * 默认服务端口：9876 +* 环境变量配置 + +* ROCKETMQ_HOME + +* PATH + +* NAMESRV_ADDR （建议）： 127.0.0.1:9876 + +* 命名服务器与broker + ![在这里插入图片描述](https://img-blog.csdnimg.cn/c9ec39af08124eb7904e5cdc2abc3b43.png) + +* 启动命名服务器 + + `mqnamesrv` + +* 启动broker + + `mqbroker` + +* 服务器功能测试：生产者 + + `tools org.apache.rocketmq.example.quickstart.Producer` + +* 服务器功能测试：消费者 + + `tools org.apache.rocketmq.example.quickstart.Consumer` + +#### 17.8.1、SpringBoot整合RocketMQ + +* 导入SpringBoot整合RocketMQ坐标 + + + org.apache.rocketmq + rocketmq-spring-boot-starter + 2.2.1 + + +* 配置RocketMQ （采用默认配置） + + rocketmq: + name-server: localhost:9876 + producer: + group: group_rocketmq +* 生产消息 + + @Service + public class MessageServiceRocketmqImpl implements MessageService { + @Autowired + private RocketMQTemplate rocketMQTemplate; + @Override + public void sendMessage(String id) { + rocketMQTemplate.convertAndSend("order_sm_id",id); + System.out.println("使用Rabbitmq将待发送短信的订单纳入处理队列，id："+id); + } + } +* 生产异步消息 + + @Service + public class MessageServiceRocketmqImpl implements MessageService { + @Autowired + private RocketMQTemplate rocketMQTemplate; + @Override + public void sendMessage(String id) { + SendCallback callback = new SendCallback() { + @Override + public void onSuccess(SendResult sendResult) { + System.out.println("消息发送成功"); + } + @Override + public void onException(Throwable throwable) { + System.out.println("消息发送失败！！！！！！！！！！！"); + } + }; + System.out.println("使用Rabbitmq将待发送短信的订单纳入处理队列，id："+id); + rocketMQTemplate.asyncSend("order_sm_id",id,callback); + } + } +* 使用消息监听器对消息队列监听 + + @Component + @RocketMQMessageListener(topic="order_sm_id",consumerGroup = "group_rocketmq") + public class RocketmqMessageListener implements RocketMQListener { + @Override + public void onMessage(String id) { + System.out.println("已完成短信发送业务，id："+id); + } + } + +### 17.9、Kafka + +* 下载地址：[https://](https://kafka.apache.org/downloads)[kafka.apache.org/downloads](https://kafka.apache.org/downloads) + +* windows 系统下3.0.0版本存在BUG，建议使用2.X版本 + +* 安装：解压缩 + +* 启动zookeeper + + `zookeeper-server-start.bat ..\..\config\zookeeper.properties` + + * 默认端口：2181 +* 启动kafka + + `kafka-server-start.bat ..\..\config\server.properties` + + * 默认端口：9092 +* 创建topic + + `kafka-topics.bat --create --zookeeper localhost:2181 --replication-factor 1 --partitions 1 --topic itheima` + +* 查看topic + + `kafka-topics.bat --zookeeper 127.0.0.1:2181 --list` + +* 删除topic + + `kafka-topics.bat --delete --zookeeper localhost:2181 --topic itheima` + +* 生产者功能测试 + + `kafka-console-producer.bat --broker-list localhost:9092 --topic itheima` + +* 消费者功能测试 + + `kafka-console-consumer.bat --bootstrap-server localhost:9092 --topic itheima --from-beginning` + +#### 17.9.1、SpringBoot整合Kafka + +* 导入SpringBoot整合Kafka坐标 + + + org.springframework.kafka + spring-kafka + +* 配置Kafka （采用默认配置） + + spring: + kafka: + bootstrap-servers: localhost:9092 + consumer: + group-id: order +* 生产消息 + + @Service + public class MessageServiceKafkaImpl implements MessageService { + @Autowired + private KafkaTemplate kafkaTemplate; + @Override + public void sendMessage(String id) { + System.out.println("使用Kafka将待发送短信的订单纳入处理队列，id："+id); + kafkaTemplate.send("kafka_topic",id); } + } +* 使用消息监听器对消息队列监听 + + @Component + public class KafkaMessageListener{ + @KafkaListener(topics = {"kafka_topic"}) + public void onMessage(ConsumerRecord record) { + System.out.println("已完成短信发送业务，id："+record.value()); + } + } + +## 18、监控 + +### 18.1、简介 + +监控的意义： + +* 监控服务状态是否宕机 +* 监控服务运行指标（内存、虚拟机、线程、请求等） +* 监控日志 +* 管理服务（服务下线） + +监控的实施方式： + +* 显示监控信息的服务器：用于获取服务信息，并显示对应的信息 +* 运行的服务：启动时主动上报，告知监控服务器自己需要受到监控 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/394df97f929849a9ae91c4510b5f27ee.png) + +### 18.2、可视化监控平台 + +* Spring Boot Admin，开源社区项目，用于管理和监控SpringBoot应用程序。 客户端注册到服务端后，通过HTTP请求方式，服务端定期从客户端获取对应的信息，并通过UI界面展示对应信息。 + +* Admin服务端 + + + 2.5.4 + + + + de.codecentric + spring-boot-admin-starter-server + + + + + + de.codecentric + spring-boot-admin-dependencies + ${spring-boot-admin.version} + pom + import + + + +* Admin客户端 + + + 2.5.4 + + + + de.codecentric + spring-boot-admin-starter-client + + + + + + de.codecentric + spring-boot-admin-dependencies + ${spring-boot-admin.version} + pom + import + + + +* Admin服务端 + + + de.codecentric + spring-boot-admin-starter-server + 2.5.4 + +* Admin客户端 + + + de.codecentric + spring-boot-admin-starter-client + 2.5.4 + +* Admin服务端 + + server: + port: 8080 +* 设置启用Spring-Admin + + @SpringBootApplication + @EnableAdminServer + public class Springboot25ActuatorServerApplication { + public static void main(String[] args) { + SpringApplication.run(Springboot25ActuatorServerApplication.class, args); + } + } +* Admin客户端 + + spring: + boot: + admin: + client: + url: http://localhost:8080 + management: + endpoint: + health: + show-details: always + endpoints: + web: + exposure: + include: "*" + +![在这里插入图片描述](https://img-blog.csdnimg.cn/7102e30a17524139b1bb8f20c1776756.png) + +### 18.3、监控原理 + +* Actuator提供了SpringBoot生产就绪功能，通过端点的配置与访问，获取端点信息 + +* 端点描述了一组监控信息，SpringBoot提供了多个内置端点，也可以根据需要自定义端点信息 + +* 访问当前应用所有端点信息：**/actuator** + +* 访问端点详细信息：/actuator**/****端点名称** + ![在这里插入图片描述](https://img-blog.csdnimg.cn/342450058b5940738d2dfe692fa63a10.png) + +![在这里插入图片描述](https://img-blog.csdnimg.cn/8c62c1bf3be0479d85f2ddcb18c34422.png) + +* Web程序专用端点 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/13dfbc9b4b3e4cd6b91cc22519c4e2a4.png) + +* 启用指定端点 + + management: + endpoint: + health: # 端点名称 + enabled: true show-details: always beans: # 端点名称 enabled: true +* 启用所有端点 + + management: + endpoints: + enabled-by-default: true +* 暴露端点功能 + + * 端点中包含的信息存在敏感信息，需要对外暴露端点功能时手动设定指定端点信息 + ![在这里插入图片描述](https://img-blog.csdnimg.cn/cf157f09d9274dd68ffe9b83f6efc106.png) + ![在这里插入图片描述](https://img-blog.csdnimg.cn/1d82e3fd9f254fd381acc37c05dfc09f.png) + ![在这里插入图片描述](https://img-blog.csdnimg.cn/76cc94690520440fa27368ebb195eee9.png) + +### 18.4、自定义监控指标 + +* 为info端点添加自定义指标 + + info: + appName: @project.artifactId@ + version: @project.version@ + author: itheima @Component + public class AppInfoContributor implements InfoContributor { + @Override + public void contribute(Info.Builder builder) { + Map infoMap = new HashMap<>(); + infoMap.put("buildTime","2006"); + builder.withDetail("runTime",System.currentTimeMillis()) + .withDetail("company","传智教育"); + builder.withDetails(infoMap); + } + } +* 为Health端点添加自定义指标 + + @Component + public class AppHealthContributor extends AbstractHealthIndicator { + @Override + protected void doHealthCheck(Health.Builder builder) throws Exception { + boolean condition = true; + if(condition){ + Map infoMap = new HashMap<>(); + infoMap.put("buildTime","2006"); + builder.withDetail("runTime",System.currentTimeMillis()) + .withDetail("company","传智教育"); + builder.withDetails(infoMap); + builder.status(Status.UP); + }else{ + builder.status(Status.DOWN); + } + } + } +* 为Metrics端点添加自定义指标 + + @Service + public class BookServiceImpl extends ServiceImpl implements IBookService { + private Counter counter; + public BookServiceImpl(MeterRegistry meterRegistry){ + counter = meterRegistry.counter("用户付费操作次数："); + } + @Override + public boolean delete(Integer id) { + counter.increment(); + return bookDao.deleteById(id) > 0; + } + } +* 自定义端点 + + @Component + @Endpoint(id="pay") + public class PayEndPoint { + @ReadOperation + public Object getPay(){ + //调用业务操作，获取支付相关信息结果，最终return出去 + Map payMap = new HashMap(); + payMap.put("level 1",103); + payMap.put("level 2",315); + payMap.put("level 3",666); + return payMap; + } + } + +pom +import + + - Admin客户端 + +```xml + + 2.5.4 + + + + de.codecentric + spring-boot-admin-starter-client + + + + + + de.codecentric + spring-boot-admin-dependencies + ${spring-boot-admin.version} + pom + import + + + + +* Admin服务端 + + + de.codecentric + spring-boot-admin-starter-server + 2.5.4 + +* Admin客户端 + + + de.codecentric + spring-boot-admin-starter-client + 2.5.4 + +* Admin服务端 + + server: + port: 8080 +* 设置启用Spring-Admin + + @SpringBootApplication + @EnableAdminServer + public class Springboot25ActuatorServerApplication { + public static void main(String[] args) { + SpringApplication.run(Springboot25ActuatorServerApplication.class, args); + } + } +* Admin客户端 + + spring: + boot: + admin: + client: + url: http://localhost:8080 + management: + endpoint: + health: + show-details: always + endpoints: + web: + exposure: + include: "*" + + [外链图片转存中…(img-cXWfQSEx-1657811363485)] + +### 18.3、监控原理 + +* Actuator提供了SpringBoot生产就绪功能，通过端点的配置与访问，获取端点信息 + +* 端点描述了一组监控信息，SpringBoot提供了多个内置端点，也可以根据需要自定义端点信息 + +* 访问当前应用所有端点信息：**/actuator** + +* 访问端点详细信息：/actuator**/****端点名称** + + [外链图片转存中…(img-KSdMaD18-1657811363486)] + + [外链图片转存中…(img-UlUbALwe-1657811363487)] + +* Web程序专用端点 + + [外链图片转存中…(img-maGlhCAb-1657811363487)] + +* 启用指定端点 + + management: + endpoint: + health: # 端点名称 + enabled: true show-details: always beans: # 端点名称 enabled: true +* 启用所有端点 + + management: + endpoints: + enabled-by-default: true +* 暴露端点功能 + + * 端点中包含的信息存在敏感信息，需要对外暴露端点功能时手动设定指定端点信息 + + [外链图片转存中…(img-6UeTKYgJ-1657811363488)] + +[外链图片转存中…(img-bLPYJP4S-1657811363489)] + +[外链图片转存中…(img-RwCI70cm-1657811363490)] + +### 18.4、自定义监控指标 + +* 为info端点添加自定义指标 + + info: + appName: @project.artifactId@ + version: @project.version@ + author: itheima @Component + public class AppInfoContributor implements InfoContributor { + @Override + public void contribute(Info.Builder builder) { + Map infoMap = new HashMap<>(); + infoMap.put("buildTime","2006"); + builder.withDetail("runTime",System.currentTimeMillis()) + .withDetail("company","传智教育"); + builder.withDetails(infoMap); + } + } +* 为Health端点添加自定义指标 + + @Component + public class AppHealthContributor extends AbstractHealthIndicator { + @Override + protected void doHealthCheck(Health.Builder builder) throws Exception { + boolean condition = true; + if(condition){ + Map infoMap = new HashMap<>(); + infoMap.put("buildTime","2006"); + builder.withDetail("runTime",System.currentTimeMillis()) + .withDetail("company","传智教育"); + builder.withDetails(infoMap); + builder.status(Status.UP); + }else{ + builder.status(Status.DOWN); + } + } + } +* 为Metrics端点添加自定义指标 + + @Service + public class BookServiceImpl extends ServiceImpl implements IBookService { + private Counter counter; + public BookServiceImpl(MeterRegistry meterRegistry){ + counter = meterRegistry.counter("用户付费操作次数："); + } + @Override + public boolean delete(Integer id) { + counter.increment(); + return bookDao.deleteById(id) > 0; + } + } +* 自定义端点 + + @Component + @Endpoint(id="pay") + public class PayEndPoint { + @ReadOperation + public Object getPay(){ + //调用业务操作，获取支付相关信息结果，最终return出去 + Map payMap = new HashMap(); + payMap.put("level 1",103); + payMap.put("level 2",315); + payMap.put("level 3",666); + return payMap; + } + } \ No newline at end of file diff --git "a/docs/java/jvm/Java\350\231\232\346\213\237\346\234\272\351\235\242\350\257\225.md" "b/docs/java/jvm/Java\350\231\232\346\213\237\346\234\272\351\235\242\350\257\225.md" index d8269e5..9e46964 100644 --- "a/docs/java/jvm/Java\350\231\232\346\213\237\346\234\272\351\235\242\350\257\225.md" +++ "b/docs/java/jvm/Java\350\231\232\346\213\237\346\234\272\351\235\242\350\257\225.md" @@ -1,10 +1,10 @@ -> 简单的说一下Java的垃圾回收机制，解决了什么问题？ +## 简单的说一下Java的垃圾回收机制，解决了什么问题？ 这个题目其实我是不太想写的，原因在于太笼统了，容易让面试者陷入误区，难以正确的回答，但是，如何加上一个解决了什么问题，那么，这个面试题还是有意义的，可以看看面试者的理解。 在c语言和c++中，对于内存的管理是非常的让人头疼的，也是很多人放弃的原因，因此，在后面的一些高级语言中，设计者就想解决这一个问题，让开发者专注于自己的业务开发即可，因此，在Java中也引入了垃圾回收机制，它使得开发者在编写程序的时候不再需要考虑内存管理，由于有个垃圾回收机制，Java中的对象不再有“作用域”的概念，只有对象的引用才有“作用域”。垃圾回收可以有效的防止内存泄露，有效的使用空闲的内存。 -> 了解JVM的内存模型吗？ +## 了解JVM的内存模型吗？ JVM载执行Java程序的过程中会把它所管理的内存划分为若干个不同的数据区域。 @@ -259,7 +259,7 @@ vm参数介绍： 在配置虚拟机参数时，会根据实际内存设置-Xmx等参数信息，但经常忽略直接内存，使得各个内存区域总和大于物理内存限制（包括物理的和操作系统的限制），从而导致动态扩展时出现**OutOfMemoryError**异常。 -> JVM的四种引用？ +## JVM的四种引用？ Java把对象的引用分为四种级别，从而使程序能更加灵活的控制对象的生命周期。这四种级别由高到低依次为：强引用、软引用、弱引用和虚引用。 @@ -296,14 +296,14 @@ Java把对象的引用分为四种级别，从而使程序能更加灵活的控 **注意:** 在实际程序设计中一般很少使用弱引用与虚引用，使用软用的情况较多，这是因为软引用可以加速JVM对垃圾内存的回收速度，可以维护系统的运行安全，防止内存溢出（OutOfMemory）等问题的产生。 -> GC用的可达性分析算法中，哪些对象可以作为GC Roots对象？ +## GC用的可达性分析算法中，哪些对象可以作为GC Roots对象？ - 虚拟机栈（栈帧中的局部变量表，Local Variable Table）中引用的对象。 - 方法区中类静态属性引用的对象。 - 方法区中常量引用的对象。 - 本地方法栈中JNI（即一般说的Native方法）引用的对象。 -> 如何判断对象是不是垃圾？ +## 如何判断对象是不是垃圾？ #### 引用计数算法 @@ -365,7 +365,7 @@ class Instance{ - 方法区中常量引用的对象。 - 本地方法栈中JNI（即一般说的Native方法）引用的对象。 -> 介绍一下JVM的堆 +## 介绍一下JVM的堆 这个面试题其实和上面的有点重合，但是，这里单独拿出来再介绍一下，因为这个确实是比较常见的，这样大家也都有印象。 @@ -427,7 +427,7 @@ public class HeapTest { 图中出现了`java.lang.OutOfMemoryError`，并且提示了`Java heap space`，这就说明是Java堆内存溢出的情况。 -> 介绍一下Minor GC和Full GC +## 介绍一下Minor GC和Full GC 这个概念首先我们要了解JVM的内存分区，在上面的面试题中已经做了介绍，这里就不再介绍了。 @@ -444,7 +444,7 @@ public class HeapTest { 在这里更加详细的规则介绍可以参考这篇文章：[深入理解Java虚拟机-JVM内存分配与回收策略原理，从此告别JVM内存分配文盲](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-jvm-nei-cun-fen-pei-yu-hui-shou-ce-lue-yuan-li-cong-ci-gao-bie-jvm-nei-cun-fen-pei-wen-mang.html) -> 说一下Java对象创建的方法 +## 说一下Java对象创建的方法 这个问题其实很简单，但是很多人却只知道new的方式。 @@ -453,7 +453,7 @@ public class HeapTest { - 使用反射，Class.forName(); - 运用反序列化机制，java.io.ObjectInputStream对象的readObject()方法。 -> 介绍一下几种垃圾收集算法？ +## 介绍一下几种垃圾收集算法？ #### 标记－清除（Mark-Sweep）算法 @@ -496,7 +496,7 @@ public class HeapTest { * **老年代** 在老年代中，因为对象存活率高、没有额外空间对它进行分配担保，就必须使用**标记-清除**或**标记-整理**算法来进行回收。 -> 如何减少gc出现的次数 +## 如何减少gc出现的次数 上面的面试题已经讲解到了，从年轻代空间（包括Eden和 Survivor 区域）回收内存被称为Minor GC，对老年代GC称为Major GC，而Full GC是对整个堆来说的，在最近几个版本的JDK里默认包括了对永生带即方法区的回收（JDK8中无永生带了），出现Full GC的时候经常伴随至少一次的Minor GC，但非绝对的。Major GC的速度一般会比Minor GC慢10倍以上。 @@ -578,7 +578,7 @@ promotion failed是在进行Minor GC时，`survivor space`放不下、对象只 为了解决这个问题，CMS垃圾收集器提供了一个可配置的参数，即`-XX:+UseCMSCompactAtFullCollection`开关参数，用于在“享受”完Full GC服务之后额外免费赠送一个碎片整理的过程，内存整理的过程无法并发的，空间碎片问题没有了，但提顿时间不得不变长了，JVM设计者们还提供了另外一个参数 `-XX:CMSFullGCsBeforeCompaction`，这个参数用于设置在执行多少次不压缩的Full GC后，跟着来一次带压缩的。 -> 数组多大会放在JVM老年代，永久代对象如何GC？如果想不被GC怎么办？如果想在GC中生存一次怎么办？ +## 数组多大会放在JVM老年代，永久代对象如何GC？如果想不被GC怎么办？如果想在GC中生存一次怎么办？ 虚拟机提供了一个`-XX:PretenureSizeThreshold`参数（通常是3MB），令大于这个设置值的对象直接在老年代分配。这样做的目的是避免在Eden区及两个Survivor区之间发生大量的内存复制。（新生代采用复制算法收集内存） @@ -586,7 +586,7 @@ promotion failed是在进行Minor GC时，`survivor space`放不下、对象只 让对象实现finalize()方法，一次对象的自我拯救。 -> JVM 常见的参数有哪些，介绍几个常见的，并说说在你工作中实际用到的地方？ +## JVM 常见的参数有哪些，介绍几个常见的，并说说在你工作中实际用到的地方？ 首先，JVM 中的参数是非常多的，而且可以分为不同的类型，主要可以分为以下三种类型： - `标准参数（-）`，所有的JVM实现都必须实现这些参数的功能，而且向后兼容。 @@ -841,7 +841,7 @@ public class MethodTest { 更多的使用方法可以参考这篇文章 [如何利用VisualVM对高并发项目进行性能分析](http://www.java1000.com/shen-ru-li-jie-java-xu-ni-ji-ru-he-li-yong-visualvm-dui-gao-bing-fa-xiang-mu-jin-xing-xing-neng-fen-xi.html)，有更加细致的介绍。 -> 说说你了解的常见的内存调试工具：jps、jmap、jhat等。 +## 说说你了解的常见的内存调试工具：jps、jmap、jhat等。 |名称|解释| |-----|-----| @@ -1039,7 +1039,7 @@ GCT：垃圾回收消耗总时间 通过以上参数分析，发现老年代Full GC没有，说明没有大对象进入到老年代，整个老年代的GC情况还是不错的。另外，年轻代回收次数`12`次，使用时间`1.672`s，每次用时100ms左右，这个时间稍微长了一点，可以将新生代的空间调低一点，以降低每一次的GC时间。 -> 常见的垃圾回收器有哪些？ +## 常见的垃圾回收器有哪些？ 先上一张图，这张图是Java虚拟机的jdk1.7及以前版本的所有垃圾回收器，也可以说是比较成熟的垃圾回收器，除了这些垃圾回收器，面试的时候最多也就再怼怼G1和ZGC了。 @@ -1349,7 +1349,7 @@ G1来源：https://blog.51cto.com/lqding/1770055 |**G1**|并发|老年代|标记-整理|高吞吐量|面向服务器的垃圾收集器，主要针对配备多颗处理器及大容量内存的机器 -> 内存泄漏和内存溢出，什么时候会出现，怎么解决？ +## 内存泄漏和内存溢出，什么时候会出现，怎么解决？ 内存泄漏：(Memory Leak) 不再会被使用的对象的内存不能被回收，就是内存泄露。 @@ -1432,7 +1432,7 @@ G1来源：https://blog.51cto.com/lqding/1770055 2) 将 java heap 的 -Xmx 尽量调小，但是保证在不影响应用使用的前提下。 3) 限制对 native memory 的消耗，比如：将 thread 的 -Xss 调小，并且限制产生大量的线程；限制文件的 io 操作次数和数量；限制网络的使用等等。 -> Java 的类加载过程 +## Java 的类加载过程 JVM类加载机制分为五个部分：加载，验证，准备，解析，初始化，下面我们就分别来看一下这五个过程。其中加载、检验、准备、初始化和卸载这个五个阶段的顺序是固定的，而解析则未必。为了支持动态绑定，解析这个过程可以发生在初始化阶段之后。 @@ -1452,7 +1452,7 @@ JVM类加载机制分为五个部分：加载，验证，准备，解析，初 此阶段主要确保 Class 文件的字节流中包含的信息符合当前虚拟机的要求，并且不会危害虚拟机的自身安全。 1. 文件格式验证：基于字节流验证。 -2. 元数据验证：基于**_方法区_**的存储结构验证。 +2. 元数据验证：基于方法区的存储结构验证。 3. 字节码验证：基于方法区的存储结构验证。 4. 符号引用验证：基于方法区的存储结构验证。 @@ -1498,7 +1498,7 @@ Java 中，对于初始化阶段，有且只有以下五种情况才会对要求 4. 虚拟机启动时，用户会先初始化要执行的主类（含有main） 5. jdk 1.7后，如果 java.lang.invoke.MethodHandle的实例最后对应的解析结果是 REF_getStatic、REF_putStatic、REF_invokeStatic 方法句柄，并且这个方法所在类没有初始化，则先初始化。 -> 聊聊双亲委派机制 +## 聊聊双亲委派机制 ![](http://image.ouyangsihai.cn/FoFkvh_XGVUdHkp3F6dYBpwE8tgb) diff --git "a/docs/project/\350\205\276\350\256\257\351\241\271\347\233\256\346\200\273\347\273\223.md" "b/docs/project/\350\205\276\350\256\257\351\241\271\347\233\256\346\200\273\347\273\223.md" new file mode 100644 index 0000000..9d46f22 --- /dev/null +++ "b/docs/project/\350\205\276\350\256\257\351\241\271\347\233\256\346\200\273\347\273\223.md" @@ -0,0 +1,26 @@ +# 面试查漏补缺 + +- 面试前，查看该公司的面经 +- 逻辑表达慢一点，表达清楚 +- golang使用不够熟练 +- Mysql + - mysql语句实战不够熟练 +- redis +- kafka + - kafka 的实现 +- 项目（actor-go） + - 项目介绍 + - 介绍整个项目的情况 + - 介绍个人负责的模块 + - actor-sdk-go + - actormodel + - 项目重点、难点 + - 设计模式的应用和抽象，提升的架构设计和编码能力 + - DDD 的开发模式应用 + - 更加深入的理解了 DevOps 开发理念 + - DDD + - 消息驱动模型 + https://cloud.tencent.com/developer/article/1656611?from=article.detail.1857333 + - 设计模式（工厂、模板、单例、回调） + - 分布式项目介绍 + https://blog.csdn.net/fanrenxiang/article/details/85083243 From aacfc6f67a4be1d231855939473f500975b0bacd Mon Sep 17 00:00:00 2001 From: hello-java-maker <1446037005@qq.com> Date: Tue, 21 Nov 2023 23:07:35 +0800 Subject: [PATCH 2/7] update --- .../Java\351\233\206\345\220\210.md" | 39 +++++++++++-------- .../test.md" | 0 2 files changed, 23 insertions(+), 16 deletions(-) create mode 100644 "docs/java/\345\237\272\347\241\200\351\235\242\350\257\225\351\242\230/test.md" diff --git "a/docs/java/\345\237\272\347\241\200\351\235\242\350\257\225\351\242\230/Java\351\233\206\345\220\210.md" "b/docs/java/\345\237\272\347\241\200\351\235\242\350\257\225\351\242\230/Java\351\233\206\345\220\210.md" index 077a179..217da0b 100644 --- "a/docs/java/\345\237\272\347\241\200\351\235\242\350\257\225\351\242\230/Java\351\233\206\345\220\210.md" +++ "b/docs/java/\345\237\272\347\241\200\351\235\242\350\257\225\351\242\230/Java\351\233\206\345\220\210.md" @@ -1,21 +1,34 @@ +假设你是一名资深的 Java 开发工程师，有 5-10 年的大厂开发经验，现在你正在面试，需要你回答下面的一些问题，并且答案需要满足下列要求： +1、用中文回答； +2、以 markdown 的格式回答，中英文左右有空格，同时，对你的答案进行重点的突出标注等； +3、对于特别有需要解释的，难以理解的、有深度的内容，加以代码进行解释； +4、对相关实现的底层原理进行对比和分析； +你可以帮助我完成吗？ -## 集合容器概述 -### 什么是集合 +假设你是一名资深的 Java 开发工程师，有 5-10 年的大厂开发经验，现在你是一名面试官，现在你正在面试一名有着 5 年大厂经验的 Java 开发工程师。 -* 集合就是一个放数据的容器，准确的说是放数据对象引用的容器 -* 集合类存放的都是对象的引用，而不是对象的本身 +ConcurrentHashMap 和 Hashtable 的区别是什么？ +需要你详细的回答，对底层的实现原理进行分析。 +然后，用 markdown 格式，重点突出，同时，如果 pdf 的内容有不完善的地方，结合你的理解补充完整。 -* 集合类型主要有3种：set(集）、list(列表）和map(映射)。 -### 集合的特点 +ConcurrentHashMap 和 Hashtable 的区别，需要你详细的回答，对底层的实现原理进行分析。 +然后，用 markdown 格式，重点突出。 -* 集合的特点主要有如下两点： - * 集合用于存储对象的容器，对象是用来封装数据，对象多了也需要存储集中式管理。 - * 和数组对比对象的大小不确定。因为集合是可变长度的。数组需要提前定义大小 + +## 集合容器概述 + +### 什么是集合 + +简单来说，集合就是一个放数据容器，它主要包括 Collection 和 Map 集合 + +- 集合只能存放对象，Java中每一种基本数据类型都有对应的引用类型。例如在集合中存储一个int型数据时，要先自动转换成Integer类后再存入； +- 集合存放的是对对象的引用，对象本身还是存放在堆内存中； +- 集合可以存放不同类型、不限数量的数据类型。 ### 集合和数组的区别 @@ -25,16 +38,10 @@ * 数组存储的元素必须是同一个数据类型；集合存储的对象可以是不同数据类型。 -### 使用集合框架的好处 - -1. 容量自增长； -2. 提供了高性能的数据结构和算法，使编码更轻松，提高了程序速度和质量； -3. 可以方便地扩展或改写集合，提高代码复用性和可操作性。 -4. 通过使用JDK自带的集合类，可以降低代码维护和学习新API成本。 ### 常用的集合类有哪些？ -* Map接口和Collection接口是所有集合框架的父接口： +常用的Java集合主要由三大体系：Set、List和Map。其中Set和List是基于Collection接口的实现类，Set中常用的有HashSet和TreeSet，List中常用的有ArrayList，基于Map接口的常用实现类有HashMap和TreeMap。 1. Collection接口的子接口包括：Set接口和List接口 2. Map接口的实现类主要有：HashMap、TreeMap、Hashtable、ConcurrentHashMap以及Properties等 diff --git "a/docs/java/\345\237\272\347\241\200\351\235\242\350\257\225\351\242\230/test.md" "b/docs/java/\345\237\272\347\241\200\351\235\242\350\257\225\351\242\230/test.md" new file mode 100644 index 0000000..e69de29 From 06129663534c448d205b3975fb3c1da11fe8aa29 Mon Sep 17 00:00:00 2001 From: javamaker Date: Fri, 3 May 2024 15:55:04 +0800 Subject: [PATCH 3/7] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E9=9B=86=E5=90=88?= =?UTF-8?q?=E6=96=87=E7=AB=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 ++--- ...42\350\257\225\351\242\230\344\270\200.md" | 24 +++++++++---------- ...56\344\277\241\345\256\214\346\225\264.md" | 1 + 3 files changed, 16 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 8e5becc..7b5ca3c 100644 --- a/README.md +++ b/README.md @@ -155,9 +155,9 @@ #### 基础容器 -- ArrayList源码分析及真实大厂面试题精讲 -- LinkedList源码分析及真实大厂面试题精讲 -- HashMap源码分析及真实大厂面试题精讲 +- [ArrayList源码分析及真实大厂面试题精讲](https://blog.csdn.net/sihai12345/article/details/138413307?spm=1001.2014.3001.5501) +- [LinkedList源码分析及真实大厂面试题精讲](https://blog.csdn.net/sihai12345/article/details/138413722?spm=1001.2014.3001.5501) +- [HashMap源码分析及真实大厂面试题精讲](https://blog.csdn.net/sihai12345/article/details/138416578?spm=1001.2014.3001.5501) - TreeMap源码分析及真实大厂面试题精讲 - TreeSet源码分析及真实大厂面试题精讲 - LinkedHashMap源码分析及真实大厂面试题精讲 diff --git "a/docs/database/MySQL\351\235\242\350\257\225\351\242\230\344\270\200.md" "b/docs/database/MySQL\351\235\242\350\257\225\351\242\230\344\270\200.md" index 1d84a7c..aa25c45 100644 --- "a/docs/database/MySQL\351\235\242\350\257\225\351\242\230\344\270\200.md" +++ "b/docs/database/MySQL\351\235\242\350\257\225\351\242\230\344\270\200.md" @@ -310,12 +310,12 @@ InnoDB存储引擎中存在着不同类型的锁，下面一一介绍一下。 - S or X (共享锁、排他锁)的兼容性 -![](http://image.ouyangsihai.cn/Fvr5OSfX9nP2Ip30O088kVx-Pdza) +![](https://img-blog.csdnimg.cn/20191022121422475.png) - IS or IX (共享、排他)意向锁的兼容性 -![](http://image.ouyangsihai.cn/Fgf-Pg6JPVJ7CmPyrdcow_5q-VZm) +![](https://img-blog.csdnimg.cn/20191022121422644.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NpaGFpMTIzNDU=,size_16,color_FFFFFF,t_70) **注意：** 任意 IS/IX 锁之间都是兼容的，因为它们只表示想要对表加锁，而不是真正加锁。 @@ -353,7 +353,7 @@ InnoDB存储引擎中存在着不同类型的锁，下面一一介绍一下。 ##### MySQL 不同引擎支持的锁的粒度 -![](http://image.ouyangsihai.cn/FvpMs-9FmTS7IKUBEv3WCm0IFJJH) +![](https://img-blog.csdnimg.cn/20191022121422292.png) > 了解一致性非锁定读和一致性锁定读吗？ @@ -372,7 +372,7 @@ InnoDB存储引擎中存在着不同类型的锁，下面一一介绍一下。 **一致性非锁定读(consistent nonlocking read)** 是指InnoDB存储引擎通过多版本控制(MVVC)读取当前数据库中行数据的方式。如果读取的行正在执行DELETE或UPDATE操作，这时读取操作不会因此去等待行上锁的释放。相反地，InnoDB会去读取行的一个快照。所以，非锁定读机制大大提高了数据库的并发性。 - ![来自网络：侵权删](http://image.ouyangsihai.cn/FhF001C8JBPwaEXPgJ9TEzFT8C6X) + ![来自网络：侵权删](https://img-blog.csdnimg.cn/2019102212142395.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NpaGFpMTIzNDU=,size_16,color_FFFFFF,t_70) 一致性非锁定读是InnoDB默认的读取方式，即读取不会占用和等待行上的锁。在事务隔离级别`READ COMMITTED`和`REPEATABLE READ`下，InnoDB使用一致性非锁定读。 @@ -382,7 +382,7 @@ InnoDB存储引擎中存在着不同类型的锁，下面一一介绍一下。 首先创建一张表; -![](http://image.ouyangsihai.cn/FqzGMzTgnaAxaSX2Ko9YVUjnmFWt) +![](https://img-blog.csdnimg.cn/20191022121423315.png) 插入一条数据； @@ -396,19 +396,19 @@ insert into lock_test values(1); select @@tx_isolation; ``` -![](http://image.ouyangsihai.cn/Fn3A5-fYhDs8rb0VvNMC1OL6B9sW) +![](https://img-blog.csdnimg.cn/20191022121423531.png) 下面分为两种事务进行操作。 在`REPEATABLE READ`事务隔离级别下； -![](http://image.ouyangsihai.cn/FhE1WGAeSkZGAq90Cx1alh3dZTVa) +![](https://img-blog.csdnimg.cn/20191022121423748.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NpaGFpMTIzNDU=,size_16,color_FFFFFF,t_70) 在`REPEATABLE READ`事务隔离级别下，读取事务开始时的行数据，所以当会话B修改了数据之后，通过以前的查询，还是可以查询到数据的。 在`READ COMMITTED`事务隔离级别下; -![](http://image.ouyangsihai.cn/FrdXfAw47rFAzRks4-4Y9IoWKtl4) +![](https://img-blog.csdnimg.cn/20191022121423939.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NpaGFpMTIzNDU=,size_16,color_FFFFFF,t_70) 在`READ COMMITTED`事务隔离级别下，读取该行版本最新的一个快照数据，所以，由于B会话修改了数据，并且提交了事务，所以，A读取不到数据了。 @@ -423,10 +423,10 @@ InnoDB存储引擎有3种行锁的算法，其分别是： **Record Lock**：总是会去锁住索引记录，如果InnoDB存储引擎表在建立的时候没有设置任何一个索引，那么这时InnoDB存储引擎会使用隐式的主键来进行锁定。 **Next-Key Lock**：结合了Gap Lock和Record Lock的一种锁定算法，在Next-Key Lock算法下，InnoDB对于行的查询都是采用这种锁定算法。举个例子10，20，30，那么该索引可能被Next-Key Locking的区间为： -![](http://image.ouyangsihai.cn/FrOLmJtKBxs70A0QHAc35CccZg2Y) +![](https://img-blog.csdnimg.cn/20191022121424137.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NpaGFpMTIzNDU=,size_16,color_FFFFFF,t_70) 除了Next-Key Locking，还有**Previous-Key Locking**技术，这种技术跟Next-Key Lock正好相反，锁定的区间是区间范围和前一个值。同样上述的值，使用Previous-Key Locking技术，那么可锁定的区间为： -![](http://image.ouyangsihai.cn/Fr-S9vxXpA--rHGiPkWMpCdhEKxT) +![](https://img-blog.csdnimg.cn/20191022121424338.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NpaGFpMTIzNDU=,size_16,color_FFFFFF,t_70) 不是所有索引都会加上Next-key Lock的，这里有一种**特殊的情况**，在查询的列是唯一索引（包含主键索引）的情况下，`Next-key Lock`会降级为`Record Lock`。 @@ -452,12 +452,12 @@ SELECT * FROM test WHERE y = 3 FOR UPDATE - 对于主键x -![](http://image.ouyangsihai.cn/Fo3ptcBFShRMwLAC1guVV4mUO-93) +![](https://img-blog.csdnimg.cn/20191022121424525.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NpaGFpMTIzNDU=,size_16,color_FFFFFF,t_70) - 辅助索引y -![](http://image.ouyangsihai.cn/Fj8hUM6slurRWb5SImLWWDM2YDu0) +![](https://img-blog.csdnimg.cn/20191022121424732.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NpaGFpMTIzNDU=,size_16,color_FFFFFF,t_70) 用户可以通过以下两种方式来显示的关闭Gap Lock： diff --git "a/docs/golang/\351\235\242\350\257\225\351\242\230/golang\351\235\242\350\257\225\351\242\230\346\225\264\347\220\206-\345\276\256\344\277\241\345\256\214\346\225\264.md" "b/docs/golang/\351\235\242\350\257\225\351\242\230/golang\351\235\242\350\257\225\351\242\230\346\225\264\347\220\206-\345\276\256\344\277\241\345\256\214\346\225\264.md" index 2ec987f..e65120c 100644 --- "a/docs/golang/\351\235\242\350\257\225\351\242\230/golang\351\235\242\350\257\225\351\242\230\346\225\264\347\220\206-\345\276\256\344\277\241\345\256\214\346\225\264.md" +++ "b/docs/golang/\351\235\242\350\257\225\351\242\230/golang\351\235\242\350\257\225\351\242\230\346\225\264\347\220\206-\345\276\256\344\277\241\345\256\214\346\225\264.md" @@ -409,6 +409,7 @@ slices maps functions #### 1、channel 是否线程安全？锁用在什么地方？ ![图片](data:image/gif;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQImWNgYGBgAAAABQABh6FO1AAAAABJRU5ErkJggg==) + #### 2、go channel 的底层实现原理 （数据结构） ![图片](https://mmbiz.qpic.cn/mmbiz_png/3wgqfEribn6fXH7I19WrA9zDKjjmfnh6uAhBkuiacRMG4zqoayxUrPtUZQHoNxic9GOvXljTCre35EUTwzrp88LaQ/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1) From ff9f2c020c89faf50641d49e4171732df8d51fbc Mon Sep 17 00:00:00 2001 From: javamaker Date: Fri, 3 May 2024 16:19:53 +0800 Subject: [PATCH 4/7] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20jvm=20=E5=92=8C=20java?= =?UTF-8?q?8=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 7b5ca3c..37bd5f2 100644 --- a/README.md +++ b/README.md @@ -182,24 +182,25 @@ - [深入理解Java虚拟机系列](https://mp.weixin.qq.com/s/SZ87s3fmKL3Kc_tAMcOFQw) - [深入理解Java虚拟机系列--完全解决面试问题](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-xi-lie-jiao-cheng.html) -- [深入理解Java虚拟机-Java内存区域透彻分析](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-java-nei-cun-qu-yu-tou-che-fen-xi.html) -- [深入理解Java虚拟机-JVM内存分配与回收策略原理，从此告别JVM内存分配文盲](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-jvm-nei-cun-fen-pei-yu-hui-shou-ce-lue-yuan-li-cong-ci-gao-bie-jvm-nei-cun-fen-pei-wen-mang.html) -- [深入理解Java虚拟机-常用vm参数分析](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-chang-yong-vm-can-shu-fen-xi.html) -- [深入理解Java虚拟机-如何利用JDK自带的命令行工具监控上百万的高并发的虚拟机性能](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-ru-he-li-yong-jdk-zi-dai-de-ming-ling-xing-gong-ju-jian-kong-shang-bai-wan-de-gao-bing-fa-de-xu-ni-ji-xing-neng.html) -- [深入理解Java虚拟机-如何利用VisualVM对高并发项目进行性能分析](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-ru-he-li-yong-visualvm-dui-gao-bing-fa-xiang-mu-jin-xing-xing-neng-fen-xi.html) -- [深入理解Java虚拟机-你了解GC算法原理吗](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-ni-liao-jie-gc-suan-fa-yuan-li-ma.html) -- [几个面试官常问的垃圾回收器，下次面试就拿这篇文章怼回去！](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-chang-jian-de-la-ji-hui-shou-qi.html) -- [面试官100%会严刑拷打的 CMS 垃圾回收器，下次面试就拿这篇文章怼回去！](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-cms-la-ji-hui-shou-qi.html) +- [深入理解Java虚拟机-Java内存区域透彻分析](https://mp.weixin.qq.com/s/WuyxyelaXbU-lg-HVZ95TA) +- [深入理解Java虚拟机-JVM内存分配与回收策略原理，从此告别JVM内存分配文盲](https://mp.weixin.qq.com/s/IG_zU5xa7y4BB6PVP0Fmow) +- [深入理解Java虚拟机-常用vm参数分析](https://mp.weixin.qq.com/s/l8fsq07jI0svqBdBGxuOzA) +- [深入理解Java虚拟机-如何利用JDK自带的命令行工具监控上百万的高并发的虚拟机性能](https://mp.weixin.qq.com/s/wPgA5SDURCAqPsWkZGGX0g) +- [深入理解Java虚拟机-如何利用VisualVM对高并发项目进行性能分析](https://mp.weixin.qq.com/s/hhA9tI_rYNkJVbF-R45hbA) +- [深入理解Java虚拟机-你了解GC算法原理吗](https://mp.weixin.qq.com/s/SZ87s3fmKL3Kc_tAMcOFQw) +- [几个面试官常问的垃圾回收器，下次面试就拿这篇文章怼回去！](https://sihai.blog.csdn.net/article/details/105700527) +- [面试官100%会严刑拷打的 CMS 垃圾回收器，下次面试就拿这篇文章怼回去！](https://sihai.blog.csdn.net/article/details/105808878) - [JVM 面试题 87 题详解](https://sihai.blog.csdn.net/article/details/118737581) ### Java8 -- [Java8快速学习教程](https://blog.ouyangsihai.cn/java8-zui-xin-jiao-cheng-bu-yi-yang-de-java8.html) -- [Java11的最新特性](https://blog.ouyangsihai.cn/java11-zheng-shi-fa-bu-liao-wo-men-gai-zen-me-ban.html) -- [Java8 之 lambda 表达式、方法引用、函数式接口、默认方式、静态方法](https://blog.ouyangsihai.cn/java8-zhi-lambda-biao-da-shi-fang-fa-yin-yong-han-shu-shi-jie-kou-mo-ren-fang-shi-jing-tai-fang-fa.html) -- [Java8之Consumer、Supplier、Predicate和Function攻略](https://blog.ouyangsihai.cn/java8-zhi-consumer-supplier-predicate-he-function-gong-lue.html) -- [Java8 的 Stream 流式操作之王者归来](https://blog.ouyangsihai.cn/java8-de-stream-liu-shi-cao-zuo-zhi-wang-zhe-gui-lai.html) +- [Java8 Stream：2万字20个实例，玩转集合的筛选、归约、分组、聚合](https://mp.weixin.qq.com/s/u042M2Sw2glBlevIDVoSXg) +- [利用Java8新特征，重构传统设计模式，你学会了吗？](https://mp.weixin.qq.com/s/zZ6rWz_t_snYNiNyOtaGiQ) +- [Java8 之 lambda 表达式、方法引用、函数式接口、默认方式、静态方法](https://mp.weixin.qq.com/s/FdzNWIsEmHVe9Nehxvfa3w) +- [Java8之Consumer、Supplier、Predicate和Function攻略](https://sihai.blog.csdn.net/article/details/98193777) +- [Java8 的 Stream 流式操作之王者归来](https://sihai.blog.csdn.net/article/details/100434684) +- [Java11-17的最新特性](https://mp.weixin.qq.com/s/QPGdNn56mCCDIUS047_1cQ) ## 计算机网络 From d1dd415d95ea1b3a3aad507bb127b8dd98c78952 Mon Sep 17 00:00:00 2001 From: javamaker Date: Fri, 3 May 2024 17:24:19 +0800 Subject: [PATCH 5/7] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E8=B5=84=E6=96=99?= =?UTF-8?q?=E4=BF=A1=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 91 ++++++------------ assets/wx.jpg | Bin 0 -> 209581 bytes ...0\346\234\257\345\234\210\345\255\220.jpg" | Bin 0 -> 27096 bytes img.png | Bin 0 -> 147043 bytes 4 files changed, 31 insertions(+), 60 deletions(-) create mode 100644 assets/wx.jpg create mode 100644 "assets/\347\250\213\345\272\217\345\221\230\346\212\200\346\234\257\345\234\210\345\255\220.jpg" create mode 100644 img.png diff --git a/README.md b/README.md index 37bd5f2..3491917 100644 --- a/README.md +++ b/README.md @@ -10,37 +10,24 @@ 👉 Java学习资源汇总（个人总结） -- Java基础到Java实战全套学习视频教程，包括多个企业级实战项目：https://github.com/hello-go-maker/cs-learn-source +- Java基础到Java实战全套学习视频教程，包括多个企业级实战项目; -- 面试算法资料，这是总结的算法资料，学完基本可以应付80%大厂：https://urlify.cn/N7vIj2 密码: ijoi +- 面试算法资料，这是总结的算法资料，学完基本可以应付80%大厂; -- 大厂面试资料，一年时间总结，覆盖Java所有技术点：https://urlify.cn/Vzmeqy 密码: j9t2 +- 大厂面试资料，一年时间总结，覆盖Java所有技术点; -- 面试思维导图，手打总结： https://urlify.cn/vUNF7z 密码: adbo +- 面试思维导图，手打总结; -👉 Java各种电子书：如果你需要各种电子书，可以移步这个仓库 [Java电子书合集](https://github.com/hello-go-maker/cs-books) +👉 Java各种电子书：各种技术相关的电子书； -👉 Java面试思维导图（手打） +👉 Java面试思维导图（手打），我靠这些导图拿到了一线互联网公司的offer，关注公众号，回复：`思维导图`； -👉 这里再分享一些我总结的**Java面试思维导图**，我靠这些导图拿到了一线互联网公司的offer，预览在下方，先来瞧瞧。 -![](http://image.ouyangsihai.cn/FtJ3PbBRdNSa1NaUr96JmUq24_yS) +**划重点**：获取上面的资源，请关注我的公众号 `程序员的技术圈子`，**微信扫描下面二维码**，回复：`Java资料`，获取思维导图，绿色通道关注福利，等你拿。 +
-**划重点**：更多`Java面试思维导图`，请关注我的公众号 **程序员的技术圈子**，`微信扫描下面二维码`，回复：**思维导图**，获取思维导图，绿色通道关注福利，等你拿。 -![](http://image.ouyangsihai.cn/FuRA5sT9JUaVbx-YD-Acor04AWhF) - - - - -
- - -
- -[![微信群](https://camo.githubusercontent.com/59d7f19ba1af85247e016858a63045f8fe9a8c19/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7765436861742de5beaee4bfa1e7bea42d626c75652e737667)](https://github.com/OUYANGSIHAI/JavaInterview#%E8%81%94%E7%B3%BB%E6%88%91) [![公众号](https://img.shields.io/badge/%E5%85%AC%E4%BC%97%E5%8F%B7-%E5%A5%BD%E5%A5%BD%E5%AD%A6java-orange)](https://github.com/OUYANGSIHAI/JavaInterview#%E5%85%AC%E4%BC%97%E5%8F%B7) [![公众号](https://camo.githubusercontent.com/6d206aa03f27a851cf994123ef7be1a8d3192d54/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6a75656a696e2de68e98e987912d626c75652e737667)](https://juejin.im/user/5a672822f265da3e55380f0b) [![投稿](https://camo.githubusercontent.com/85a04ac4953a80940570b5c86ce73a1d34ff1542/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6373646e2d4353444e2d7265642e737667)](https://blog.csdn.net/sihai12345) [![投稿](https://camo.githubusercontent.com/6efc9c83ef8e85b19ce2853b5f69d68255f0c037/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f62696c6962696c692de59394e593a9e59394e593a92d637269746963616c)](https://space.bilibili.com/441147490) -
### 目录（ctrl + f 查找更香：不能点击的，还在写） @@ -216,7 +203,7 @@ ## Linux -- [java工程师linux命令，这篇文章就够了](https://blog.ouyangsihai.cn/java-gong-cheng-shi-linux-ming-ling-zhe-pian-wen-zhang-jiu-gou-liao.html) +- [java工程师linux命令，这篇文章就够了](https://mp.weixin.qq.com/s/bj28tvF9TwgwrH65OPjXZg) - [linux常见面试题（基础版）](https://sihai.blog.csdn.net/article/details/118737736) - [linux高频面试题](docs/operating-system/linux高频面试题.md) - 常问的几个Linux面试题，通通解决它 @@ -225,9 +212,9 @@ ### 数据结构 -- 跳表这种数据结构，你真的清楚吗，面试官可能会问这些问题！ +- [跳表这种数据结构，你真的清楚吗，面试官可能会问这些问题！](https://blog.csdn.net/sihai12345/article/details/138419109) - 红黑树你了解多少，不会肯定会被面试官怼坏 -- [B树，B+树，你了解多少，面试官问那些问题？](https://blog.ouyangsihai.cn/mian-shi-guan-wen-ni-b-shu-he-b-shu-jiu-ba-zhe-pian-wen-zhang-diu-gei-ta.html) +- [B树，B+树，你了解多少，面试官问那些问题？](https://segmentfault.com/a/1190000020416577) - [这篇文章带你彻底理解红黑树](https://sihai.blog.csdn.net/article/details/118738496) - 二叉树、二叉搜索树、二叉平衡树、红黑树、B树、B+树 @@ -249,14 +236,12 @@ ### MySQL -- [MySQL深入理解教程-解决面试中的各种问题](https://blog.ouyangsihai.cn/mysql-shen-ru-li-jie-jiao-cheng-mysql-de-yi-zhu-shi-jie.html) -- [InnoDB与MyISAM等存储引擎对比](https://blog.ouyangsihai.cn/innodb-yu-myisam-deng-cun-chu-yin-qing-dui-bi.html) -- [ 面试官问你B树和B+树，就把这篇文章丢给他](https://blog.ouyangsihai.cn/mian-shi-guan-wen-ni-b-shu-he-b-shu-jiu-ba-zhe-pian-wen-zhang-diu-gei-ta.html) -- [MySQL的B+树索引的概念、使用、优化及使用场景](https://blog.ouyangsihai.cn/mysql-de-b-shu-suo-yin.html) -- [ MySQL全文索引最强教程](https://blog.ouyangsihai.cn/mysql-quan-wen-suo-yin.html) -- [ MySQL的又一神器-锁，MySQL面试必备](https://blog.ouyangsihai.cn/mysql-de-you-yi-shen-qi-suo.html) -- [ MySQL事务，这篇文章就够了](https://blog.ouyangsihai.cn/mysql-shi-wu-zhe-pian-wen-zhang-jiu-gou-liao.html) -- [ mysqldump工具命令参数大全](https://blog.ouyangsihai.cn/mysqldump-gong-ju-ming-ling-can-shu-da-quan.html) +- [InnoDB与MyISAM等存储引擎对比](https://sihai.blog.csdn.net/article/details/100832158) +- [MySQL：从B树到B+树到索引再到存储引擎](https://mp.weixin.qq.com/s/QmG1FyWPp23klTVkTJvcUQ) +- [MySQL全文索引最强教程](https://blog.ouyangsihai.cn/mysql-quan-wen-suo-yin.html) +- [MySQL的又一神器-锁，MySQL面试必备](https://sihai.blog.csdn.net/article/details/102680104) +- [MySQL事务，这篇文章就够了](https://sihai.blog.csdn.net/article/details/102815801) +- [mysqldump工具命令参数大全](https://blog.ouyangsihai.cn/mysqldump-gong-ju-ming-ling-can-shu-da-quan.html) - [看完这篇MySQL备份的文章，再也不用担心删库跑路了](https://blog.ouyangsihai.cn/kan-wan-zhe-pian-mysql-bei-fen-de-wen-zhang-zai-ye-bu-yong-dan-xin-shan-ku-pao-lu-liao.html) - 关于MySQL索引，面试中面试官会怎么为难你，一定得注意 - MySQL中的乐观锁、悲观锁，JDK中的乐观锁、悲观锁？ @@ -265,7 +250,8 @@ - [MySQL高频面试题](https://mp.weixin.qq.com/s/KFCkvfF84l6Eu43CH_TmXA) - [MySQL查询优化过程](https://mp.weixin.qq.com/s/jtuLb8uAIHJNvNpwcIZfpA) -- MySQL面试官会怎么死怼你呢，我告诉你回怼他 +- [面试官：MySQL 上亿大表，如何深度优化？](https://mp.weixin.qq.com/s/g-_Oz9CLJfBn_asJrzn6Yg) +- [老司机总结的12条 SQL 优化方案（非常实用）](https://mp.weixin.qq.com/s/7QuASKTpXOm54CgLiHqEJg) ## 系统设计 @@ -296,14 +282,14 @@ #### SpringBoot -- [springboot史上最全教程，11篇文章全解析](https://blog.ouyangsihai.cn/categories/springboot2-0%E6%9C%80%E6%96%B0%E6%95%99%E7%A8%8B/) +- [springboot史上最全教程，11篇文章全解析](https://blog.csdn.net/sihai12345/category_7779682.html) - [微服务面试相关资料](docs/microservice/微服务相关资料.md) ## 分布式 ### dubbo -- [dubbo入门实战教程，这篇文章真的再好不过了](https://blog.ouyangsihai.cn/dubbo-yi-pian-wen-zhang-jiu-gou-liao-dubbo-yu-dao-chu-lian.html) +- [dubbo入门实战教程，这篇文章真的再好不过了](https://segmentfault.com/a/1190000019896723) - [dubbo源码分析](http://cmsblogs.com/?p=5324) - [dubbo面试题](https://mp.weixin.qq.com/s/PdWRHgm83XwPYP08KnkIsw) - [dubbo面试题2](https://mp.weixin.qq.com/s/Kz0s9K3J9Lpvh37oP_CtCA) @@ -311,13 +297,7 @@ ### zookeeper - [什么是zookeeper？](https://mp.weixin.qq.com/s/i2_c4A0146B7Ev8QnofbfQ) - -- [Zookeeper教程](http://cmsblogs.com/?p=4139) - -- [zookeeper源码分析](http://cmsblogs.com/?p=4190) - - [zookeeeper面试题](https://segmentfault.com/a/1190000014479433) - - [zookeeper面试题2](https://juejin.im/post/5dbac7a0f265da4d2c5e9b3b) @@ -325,7 +305,6 @@ - [RocketMQ简单教程](https://juejin.im/post/5af02571f265da0b9e64fcfd) - [RocketMQ教程](https://mp.weixin.qq.com/s/VAZaU1DuKbpnaALjp_-9Qw) -- [RocketMQ源码分析](http://cmsblogs.com/?p=3236) - [RocketMQ面试题](https://blog.csdn.net/dingshuo168/article/details/102970988) ### RabbitMQ @@ -343,8 +322,6 @@ - [kafka面试题](https://blog.csdn.net/qq_28900249/article/details/90346599) - [kafka面试题2](http://trumandu.github.io/2019/04/13/Kafka%E9%9D%A2%E8%AF%95%E9%A2%98%E4%B8%8E%E7%AD%94%E6%A1%88%E5%85%A8%E5%A5%97%E6%95%B4%E7%90%86/) -- [分布式架构文章](https://blog.ouyangsihai.cn/fen-bu-shi-jia-gou-xi-lie-wen-zhang.html) - ### 消息中间件 - [消息中间件面试题总结](docs/project/消息中间件面试题.md) @@ -354,7 +331,6 @@ - [Redis设计与实现总结文章](https://blog.csdn.net/qq_41594698/category_9067680.html) - [Redis面试题必备：基础，面试题](https://mp.weixin.qq.com/s/3Fmv7h5p2QDtLxc9n1dp5A) - [Redis面试相关：其中包含redis知识](https://blog.csdn.net/qq_35190492/article/details/103105780) -- [Redis源码分析](http://cmsblogs.com/?p=4570) - [redis其他数据结构](https://blog.csdn.net/c_royi/article/details/82011208) ### 分布式系统 @@ -363,8 +339,8 @@ - [垃圾收集器ZGC](https://juejin.im/post/5dc361d3f265da4d1f51c670) - [jvm系列文章](https://crowhawk.github.io/tags/#JVM) - [一次JVM FullGC的背后，竟隐藏着惊心动魄的线上生产事故！](https://mp.weixin.qq.com/s/5SeGxKtwp6KZhUKn8jXi6A) -- [Java虚拟机调优文章](https://blog.ouyangsihai.cn/categories/%E6%B7%B1%E5%85%A5%E7%90%86%E8%A7%A3Java%E8%99%9A%E6%8B%9F%E6%9C%BA/) -- [利用VisualVM对高并发项目进行性能分析](https://blog.ouyangsihai.cn/shen-ru-li-jie-java-xu-ni-ji-ru-he-li-yong-visualvm-dui-gao-bing-fa-xiang-mu-jin-xing-xing-neng-fen-xi.html#toc-heading-8) +- [深入理解Java虚拟机-如何利用JDK自带的命令行工具监控上百万的高并发的虚拟机性能](https://mp.weixin.qq.com/s/wPgA5SDURCAqPsWkZGGX0g) +- [深入理解Java虚拟机-如何利用VisualVM对高并发项目进行性能分析](https://mp.weixin.qq.com/s/hhA9tI_rYNkJVbF-R45hbA) - [JVM性能调优](https://www.iteye.com/blog/uule-2114697) - [百亿吞吐量服务的JVM性能调优实战](https://mp.weixin.qq.com/s?__biz=MzIwMzY1OTU1NQ==&mid=2247484236&idx=1&sn=b9743b2d7436f84e4617ff34e07abdd8&chksm=96cd4300a1baca1635a137294bc93c518c033ce01f843c9e012a1454b9f3ea3158fa1412e9da&scene=27&ascene=0&devicetype=android-24&version=26060638&nettype=WIFI&abtest_cookie=BAABAAoACwASABMABAAjlx4AUJkeAFmZHgBomR4AAAA%3D&lang=zh_CN&pass_ticket=%2F%2BLqr9N2EZtrEGLFo9vLA6Eqs89DSJ2CBKoAJFZ%2BBngphEP28dwmMQeSZcUB77qZ&wx_header=1) - [一次线上JVM调优实践，FullGC40次/天到10天一次的优化过程](https://blog.csdn.net/cml_blog/article/details/81057966) @@ -378,7 +354,7 @@ ### Git -- [实际开发中的git命令大全](https://blog.ouyangsihai.cn/wo-zai-shi-ji-gong-zuo-zhong-yong-de-zui-duo-de-git-ming-ling.html) +- [实际开发中的git命令大全](https://sihai.blog.csdn.net/article/details/106418135) ### Docker @@ -399,7 +375,7 @@ ## Java书籍推荐 -- [从入门到拿大厂offer，必须看的数据结构与算法书籍推荐](https://blog.ouyangsihai.cn/cong-ru-men-dao-na-da-han-offer-bi-xu-kan-de-suan-fa-shu-ji-tui-jian-bu-hao-bu-tui-jian.html) +- [从入门到拿大厂offer，必须看的数据结构与算法书籍推荐](https://blog.csdn.net/sihai12345/article/details/106011624) - [全网最全电子书下载](https://github.com/hello-go-maker/cs-books) ## 实战项目推荐 @@ -411,12 +387,10 @@ ## 程序人生 -- [我想是时候跟大学告别了](https://blog.ouyangsihai.cn/wo-xiang-shi-shi-hou-he-da-xue-gao-bie-liao.html) -- [坚持，这两个字非常重要！](https://blog.ouyangsihai.cn/jian-chi-zhe-liang-ge-zi-fei-chang-chong-yao.html) -- [2018年年终总结，你的呢？](https://blog.ouyangsihai.cn/zhe-shi-wo-de-2018-nian-zhong-zong-jie-ni-de-ni.html) -- [多去了解了解自己](https://blog.ouyangsihai.cn/duo-wen-wen-zi-ji-xiang-cheng-wei-shi-me-yang-de-ren.html) -- [关于考研，这是我给大家的经验](https://blog.ouyangsihai.cn/guan-yu-zhe-jian-shi-wo-you-hua-yao-shuo.html) -- [从普通二本到研究生再到自媒体的年轻人，这是我的故事](https://blog.ouyangsihai.cn/cong-pu-ben-dao-zha-shuo-cong-da-xue-sheng-dao-zi-mei-ti-de-nian-qing-ren-wo-fen-xiang-wo-de-coding-sheng-huo.html) +- [我想是时候跟大学告别了](https://blog.csdn.net/sihai12345/article/details/86934341) +- [坚持，这两个字非常重要！](https://blog.csdn.net/sihai12345/article/details/89507366) +- [关于考研，这是我给大家的经验](https://blog.csdn.net/sihai12345/article/details/88548630) +- [从普通二本到研究生再到自媒体的年轻人，这是我的故事](https://segmentfault.com/a/1190000020317748) ## 说明 @@ -446,15 +420,12 @@ 添加我的微信备注 **github**, 即可入群。 -![](http://image.ouyangsihai.cn/FldnPFgz_u_3kt7YH_sHhAQL1kyt) - + ### 公众号 如果大家想要实时关注我更新的文章以及分享的干货的话，关注我的公众号 **程序员的技术圈子**。 -![](http://image.ouyangsihai.cn/FuRA5sT9JUaVbx-YD-Acor04AWhF) - - + diff --git a/assets/wx.jpg b/assets/wx.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3fd7f117b74d093ecfce6744e9fd5730e2a2eb00 GIT binary patch literal 209581 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
k!;y5c+;*z`Zy24&xRyivI_il{1@ zR3)c)6tC4I?A^;w8cERq{vbj>Eke}4MBza8W&`i}+*G6&+YPu+KTpX@bJn-PH{i!O zSNF5iw8B&+^|1Ou`}G0`vPhRh!82=x#@MpYWfUwK4Xq}qvywM-SnoM7WZT!RtjhQv zNZd}|6j`OYr|Qh)`oEK2(vRi7xzy~&|bC?_VpYmSEN@9;|IT`B2`uB~&<=4oy`qx)$hHTTxDz=&; zRl#X7jiep*b^1j5x^CjUS+fW}x~6y`THJmk?VLWHM$5?_oaD#@-pNuTT>iP=FF z4$$@-B0egHJBIPN@L`_hq0oD?XD0q__a1XIA@L@9>;$W(Jpz|n21q;{i1<m+|xIYuh+ia67CA zc(0ctKbaDNmC{o%hoH}GDR7W7P#_M{8mXx1UU-UCZCQd zS(3joyvJA_?E?MGI@82ienLTq z3eSpfwCf6YqYSd(TgR`Re3-e8)e4UAdmakVE+mIaPM!HribXx=mwM;kwOi@8fMe$U zMa=4)lYw>0wA0e~h@&u^paFk7xy5fYFMDm`C-U)Al$G zQfx8cY(fI}F3pGd=Sl7;tY+1f*{9hVL>%J-P7V*^2B>#4Uve%}7Ohr%RZizmG5xTM z?{3u~f&gIt;)Q%C)or3kPo|HYr_(@w-%$rkEU&TEK0n!??R`Vlalp`4^`$921ExTW zqW;TV{Asq{!O1Ov;B^ax51r3y9w-LClc=kHzv%cvD=6pi^t0=|mwR?~pF&m%&Jivj z1+s&D2{-TG0FCYE89`+jXoH+=XINcXxXMCW;qHS#NP)!ney~2->y!}3kY@pj{jN_a z8KO1^3?B=o5K`(hm69N|ik=c&gg?j>oUo!B!`WrD3GMh6p{VmJs!2k-qN=#4~>8Ztb?N`M8eyOsY+lcMR=Wei(0 zRp+#WBC7h8e0O*~4~AAt#^54?^~p+G1SA3LV|HL5g$Fz9-SAhsf8XzhOfphD>e zzepLhvvj2GMTjp$rF?G|O;M-o*E&9Z>;QG>Y;hoWUBc!g1G2JOzG@XB!>;irh*+zL z`&7Uf(xTQE7Nbs<2Q>>nMgz?cfXdwuNFuU4yLv8x&Z`)P%O$4|w`W?jroG;9F7R)Y zZCo)yQ%cD-zdIx&vuViDw2KM!wQp2G>O-4@{0f#m$w1Hg(ZW}(KpmKK%6x9MMsDxL zb@#<*0ImT3FhZWkU`%Xwc9s zP@vpTM7K^vpJ+{t%eZlU6*|}GEmH&SIlvo_S+MY zZCTP=#l2!oy_HfHM7yf0&l8Grm_b8e>b1n})J?(F^YYdB2M3x?hHi6(#enSaCop!Q z$@@(CNbf55rU^VleL2{4 z6=d)M4HVn+5u#L3T9415-uhL0%Y@t$h>VhI1A;CeuW|&mKpw=BRAVK#l$Z5$>UE0LsEokZ3i>qDYH{k)pI#*rh8|vdGSg9C z+Qe98(Ts40dkDgm&ClWvwu2MSVG z@W#z}NJDPF>zwV%=qGR`i1yJiHvBqZ0hI9bpt~ZGTfAAGzGAlb4vFVqFp@+9JRlc( zIF)vDgH>@aB;G{FcZ3eTm!#S>Kez=>gRk>%f#q1!#;&0RQMy!zZmbgpWsg2RFK(j_ zs{yHZBvgYjpAJeRZMr!_dSxV*U!Cn)d)f=O&+uk>Mm4umi9SV2N1F_bFkSq#$9yS# zC3syNOuQ7xesJ@OV!C*O*L*S93T{b#vfBNmc24Qk`MRKcIZ>if`wiFr6YiZ{tR^I; z{m2iRMh&(jv`O3&(PKy_)3*S;{I28AX-_xKwUELCoy+K-CbCguFG@4dP1MKnz7!;3 zJa@bR&Vx#~u?=L)k2>=FdETxq%>ME{?_OyX?)3TEa`v4paLjm4mE+_Q3nI(R3)Z7< z_*HL!S8wg^(;E~LaCIx3kZ=OcdV_PaRr)@uwRl2;7=1b#9`3iCMz4p#kjzCuruI8+ z^G2++kajVaS04)zUpdo%uR(+m9Cmi&x&GKp(IAQ45Hj9q3$h)|Y%b-_<$MAo9t9p9 z_;ho0)QGk%M0^|dtS@4cjLkK){76ro9HH{hW)h0Ih!x$1-dHf+Y-2gE0(;=6+!5A@ zT~m?Cyw=P)=kYq=Bo8ehB5I0W=p*rTtd9NsnKYfQS2=c4r&_l!7`ir1CRQfB^k;Zc^IK_BKcnVgojVuK z&odNz`N}Ws(R3*a<~6CY%y8zU#TOWtPg=}J9L7xXgiDpZo*+Hs5(;=bm4n6h^R43p z`y}rgQ=N`j``(gQPyC0TRacj^a32r3n>+w)%=~+6^=3IN_|fwYRs6%>LPT}q3BCxe z=Go2jxyWjlKz&2?VUDNC`<0(D z{GXT*Sv}>e~js2<29sePrUQON3$f=UX>CIlsS!%jXq{F_LvN_Bo6tS5vr$e?saq! z5h?oQ_H{hmm&wV2sea|>iGdXP^>HF0X8*{u=yFvbJHC8AhkuXUrfoL_?TaUQz1e00 zODgPBTnr|2PsF?02QT_`dv9dl)%a>nTE2eyQ0U#LM%J_2>6@Y}@WW!f1*&zvccol-w5()?+KAl+oVbTDx-h?Y4`eh5JdhU?6?1F~fO2oeqZ5gQ?@DuR)YOGIZ#>H0SZF#A9st8v{s(r*5eIns>|* zeP!j?Fg)C<*d+Y2x{hM9;il<)Lu;zM-&?4XywOdJJG)^4?O=o;aH4(V7cr1S`{I=AIw|8s%t*u1*5B88 zSb^-D-Ow$7j}gQQPRL;(pU9V+Pr`JjjkZI^rswlIQo_YOOYf*QhJ;9vz#!Ea$RThG z^pbgngaxosHOlQ_7it{T6v#|et+~gBj7Ci1Vua}CP<3Q!PHJ#M`wy950A#LHTK3^3 z?w%UknZ_9D9`B-u7&pvWXyM6^Il+xkF~q&AsJWA5wq$vqcigPPVmjW~^k0)Yfya7s zr90XPH)wYbAj`S$0m=O7!*jIKp&Eyl)axAoHTCbs^~G{X-2s;& zH^}stc!7%7&n2vXnXa;S6)$yoxE8hqyW_`jiZ?{YZAGvWZMdsWvH%b6zEZS9|Zx8O}M&o z!t|>rpSY*)o9G?tU#?d8tF-tCR(ZAB*BHue=dd~{qU#gLr?PmnPtK&!vj~-T##Bc< zcx|4n4d*W8vC`7|823Xtrb$NH@Oefsh3+qPW(zJ=XH(4^6#1$hrUsVvhTZm=Nu=y~ zwJyEpgq?>x@=EI`WkquANjxTJ`yme}z2!+%t2^yw3dVC*t z+H>kEO@nIoVxdBULwpwyiKkv7m0IXCBQ;O$F7&X6x~3Q2<(t(+l3p#jc#!7^ ziFP%%S_c)TiWCV8?#9JGBb%Is)sCZwf3T7ov8H^PvulS{rVhB{oHeKqRzEnj&TK=9 zdU)Aa!D%fLsirO_uHpihG}uj?;UliG#X?!&nrWL!(Iw`M0RyOcO`mROz;lxYF+egg zWK<+zO6qPOp$vNG0F|AB0klx^e)qezBj8mb;){SW_+!vD)x6t@0Fc44ceh@!0|eY5 zl@3uQYA4Q;*pyLu<)5V0e;=Iu>(FE=7#ID$=X$K=<{}$5Dsz^cVFT|R;WnrZ6Uuo*nEHyj`SPrgiC+^Q& z=SFE1Fj)8NsO@#=|N5#qv?|ZjWD-_bGI1;>ykMc$sp8Aeugh6Z52>YmF<3wX&0AoR zJLt@J%l+8EcJ{EfCC*$MVj^?Ezd>TD-sL{=n&>SN8wxPXUcKY#;K`htN1T^#E{Uw_ z5Fp9PrKG~HKsw)WI8oz%q&cn&(KJF=(wL40*2fUzzE>g6Rm*61cQ;JzQQiXT$>x!W z1`8{aXAGgNJHqifS?Di_QrI*i#Vxsd&~{TNx>J6hvkqMmOxyy4?ca0jHoyCe>hZhx^(D?(-*&IwCkW}M3LZRD38~sqIThLMFmDatbd;4i&o|iy zr~L?UQkO6Y#MAG#Go8c5YVm7OmvSp`Z_RhjB44)^+k$C<&dS~LFd2-b-+TG+W{kgk zj*@$-kO-OaSKQ+pmtQ1^-9^t2>6ppo38sTXAM5DnFvPKOMiaw87&~b8)6H_gaX2<@oB$-xRMU}9SA0m1+~ZH5rQ*`O1-RR;9+Lv2cdKJaFO^HD5Y5drRnr5q zuec5&+q!ke7=t=DW>=ft4mU*w(R1^1j&wAFNf6TeK*CT$8ZTk;XHf*|M`Z=v6+WTe zQd)~-Htioonf7M!A3?y+e0c5kafzmAPaQ)hnP_MT3lOBAK%SUc$t*-pHPU1Onfx#W zj3FS!J$vZ5RKlM^bG4Q;RS&qN>uj-V8qm5Se`kWBteC$?jfP4HPy56rX1+|cll$l{ ziJwN2*kmV%f|4XyN*EnjK2a?@GXC;KtsziSnK~+DN&gzjB#lmz%hgg%_F*=yI)Xo~ zpEZsmr~IgP4nvG;&PhYrO3hl52QuuS(q>6$$|`P?Djx87%C@u-o*+ci0duq@XkdMf z8!?els$X=PaD>w#NTmn{!wtS^eQWF4)u<#<_`JTnywTo4Au`g+&HyFN_cx1m>-&Td ze2|AuWR!eHeuH0k{rWz4vYxUkGG!BaciTOypE7Twk9=Q?|P8~F7+0ReF z1KpKXxV$EAmjzkqf)vP zQY*Iv93aHMI>l_VuKHPUS*01CIEKf|5jfy|uZ=t*E!ShqGm7d}AV+)cGqzO1v$$vx z?~>BkEA5_NzQv(}qPnWoL8T%L$P2;&v#e$9C{JmN1AE@^9nj$rW?C$rkelN2al|Q+ zkB>aH+=}hRuQQ{zG?w`mS<1Cg@>V>1Hv9enyVS*W&`cC)WoNss zGs4WkBgI}16FyaK%7NLfb$izMgTU(Rohy`EAR_vWkkWqaDWfy)$DiMic3VO$y(k`8 zNnh=R-hkTz%aI{uw}9;}01KWzbm(qWMxj3~K=(0Bdrt)Y_SqRuo;Waj!MY`&J6H3H z;536p&6OL4CWRZdp7M!h%nb`zH23`8Y1qNg4a&If+E+BmQ%do6>#3?zU6JCr5*;K# z60zOI?&TMz``RJTLh5gU0h#Nk63z-%b&nOqhf0?g64$iqEI+y5%-F#$PM%GN4Ozyd zmm4~?yA+qq@60`}N-{39@-pi^`WiE4w+OH=h0?{$*+*@?m0_io^ik-oj%VQaGjerN zn<#e(gZE~H$7jWI^@W{?s>5ipodnRKPe?dMLy^iyLpZ=A0s8mP*#egcb3(qbo?5=# zF`=D8X=?3g{#IZ!@*J=g6dP0r=kmUgUh~a;OXHgns`{e6pw;S!SxS|$AumgQKF@nA zhtyg#bc6g9T=tApRi>P~9q-Sb(gv-vOGS=WcMW~eZYD9#d3?$XvAsba1ew&Q8>_pU z68D5Reh$1S+ls(BiEk7ccgT1X-2K4px}7BDcifzUVVSX_G!NKX>`5k zEZ-LY0~}~Q$6NCkB%ekNktNBeAe);jiBUW^CAD)`68l|^kHtTb9n=gL%k0>rk3U&b zgO)QOv5DfWSlsA0k(B)mrabo>q?7$DcZiGWsChYf;gX1w@zULde(iqDtYP0vUbc>) z$(TG*EnTC>k90TCObD4#Z*){ypXQ1P)vT%PGc?so%vn7k`Q?zSzyDzCoisl==5t8z zo2!+JDfY8L<&_8m%WQWIY$cc^?)@c#g>&5rw93T>uNv98kB+&S_mYICy9A8e#!r-= zj6jC-FeBbFyB6*!Ayk=I)URi+Wqzx6O;HLp`Fc|MhI%Hd&WA(T++Cmlg*s^0G~gYr z37+O*R$QEZF`-)UZ1t_EbbBG3Nh2M(_=yj*KG9i}(yfP@^FrH=he^P3G6XSHzpz&z_d$VU?|(`>(vOP^3XhKw7%Ha|r2D5s>a?7`kET5b5p) zDH(cThVecB`@Hu)_ak38XP?<;ueE-4P`W>TVmI#xq9QicMoc~_^?XY4{L>5dO-wXP z*;ciTvxu>=9$7YsyTWPp&Zg#0W)^+!{>f}jweQ))>`YYoHo1l5??ti{7On00sEvt50gisY|_oMa#%0i<8-V4FyiL7)LmFgBz?*uGK<-HI*6<|RDJzkr<=6M z+QXJAn^m~mXN|jNxUqJ6lXW$`?(H+~r1U#&fH}VsOE&E{G`k`7nz$8O->iZ;x+YP` z`OT_AdTBB#mA>`4Hggf!!O;X~i zCJ*j+70U_B`Vn=jp@|!9@CPwWod#Mec{rnH>Tud1r|LbrSrPk*hR-i^UMO9AwjPxk zP|$(nC3+M~YV&T0Pe1xq6|?$rJAPUhPDc ztKRuIohDU|c)0fxqS%2;e}-ZWQEA8O*I<5*}x&jGFPt zwWZFWor;gwwTN#D$S?R$A7$whDaihr3R?~MBkvonz~c$M0*PmuPHGo`R=Kk8AwbAu z6|{iI|ADGPhhxU_gISX&&L6$)uuYsx`+pXO|6?TkU&&UMnARbSXFu3)0=u;EA;XV) zED4Q@tBU+J{^1kt=YMQjQr?T`gQk}00!2#(Uj@pVbEHN3WwTlu+hA+JsMUtGi)Jjx zmLe*C#ThUKGfa;FEMNs7(9&VjEJ#lY<^Wm-c|Z)|mHl)pm|ua@#g=nslCeYE29zJe z{=g>dBi&4=o3;}BgZ0cGzQfw=x%j`jBV@&L!}3Z5ezg;+f|T_e9|+NA3F~nFZXR*5 zJ@V3ySWD(kU~|P?`~fnj7OaY=sba>mA2)})y*=iV^$eG}p!=A?#n84nlEd0qb7~AV zcZ*CBypT%U61TA+It@8BPA&~w6JdILGog$ z29O&F1ZO^9xw&} zmJLo+7|;Cz=Fep=(c#|T7akFEJ3Pd54F$8W+N<+!VU#U1JiN}2gGrN&oFdI3tSuL$ zd!t;rl7yZ%x_<>fiB&(nUECHa*O!ZaHJO|o z(`ig(TtYX?CuxhkD2(>8#p(e|Z~}o*2J#fkwf$`SsaKbQ{K|NZ3L@n781uK+B~;R`GB!kZ zhifBBjrNULWCX-epRqb;p*&~qE5GbVAuA?Pg^{U}$yL!>IkuYJ?gAU;>*{-%uMS079-{|MO zGZQ!|P_Ow;4M`19`E{+*uf~N9A)D_@3a&!YlX?T4y(+YQWL#8Wl;9%uks8Lcf^ z)5cwVM*T%qD9!;}+3^Ucu#Dn9MrmhxN$r`ov9h5l3 zPe2P%EKac3J~zKr^5w5j%C@<6F`<1T9n#8y(~!vijlLLd548(dQpZy1tS?%&pmj%u z&pvrhFauX4R9b#6c_G1C9aY>+|6xJ(J0p2h#o@t&tluEPZna7oF4ER?YzBMrpP46q z-&ub0u!xs?wMDmR_4AL%&i(u)O!>y3ks=S}Ry{Hs+o-684K@3jNvEz{12|O*VngOq zM`Qofd1y6{ztwh`p)sN5`R3b&tNIWi?#Yvu?&qS< zq-^uL zl=F@IsIb{=FFr$l(y;U2f1sSP;1}-=wXV7K5}q~fQI$#j$i@5ryet%-|JVg!&z1Kb z=I#|;d=F;L&%gMdT}fr3j$K+T5L1Ga{E2TU_n|HM2SVX7C5zJjTF(DeiVp@elkrzt zb5e_hfw31Dc5`u}^&($>&jApBzN`+QWPg3?r#bO}0vr1Bsu&;#0Js*E8I8>U8iSl$s^#S6GN#IIp0w zj+7d$!x0iEjwMG16l>(X#2Enu7E&wzb6(iVF}+t!%?>{JFGt-J*_<{GnmcV zxEZ_r9;K~|J)r`uj9Bhnlpi{*pOup+3{^$+cI)3GR;o#|#O9~e7j1*PIEabbtoP+^3Dyb`()I% z+7gXm^IG}ES{vi9Z-plZ$N(w8p=U97-!`BT#pZ$)SE=X>m5v&rfef#Idu=ycB45{ zwyY=Mb@OOCOB9bCxbD6fdIr}Q%I0r;OV%i5z$h4cz6>~EPD}*Qdceq^=FC%NB9G)i z+#P9?5Z0{7jrmFv38mlvhYN44sx633Z#~+N5j>$XTu^hFdTZM;(Dgxj%>Ghs;~xl3 zx_qsT#P#_e07ev5KEZkLgiJXO(oU#>3o!L4`~O;(e;^0Z^xh3<@>oWR5uy=BQ+5kq z`uy536OM4+Klukb%U{<()|@3=RR*YVr@NAztekre>`J-H7~_fxKk zkOX$@O2mC*g<$81>v!Kl6L%HG~bZr=kDyJ#Kn-D zA?*)~!LTjbnjg1noqmmT5ubll@F(c`8FZm_c7#R64Y$FQff5OEwzX^WyM44++p^bT zH@7$U_#uT787~j?n-Pdlz!G3=9QV0tdVcJ1A~oyZ zM?rchq}dk>E-cQgI<@Mq!dJbY-SFNZYB*%T`(`nBgWV6Z zLd#7hWQnmER@slV*Z#@#OETU)bH!`dV#tsl_1SsmWD|Pxd;(_=R-#7mbo|Yx7tz(2 zN}f_}Lc^aRF4y~Hr?3gUi;+P|AGA#Pp`s$Ml9R8s@?GZf^@jn(4AUXSj`AQl> zF^(cC$Aa@JZu8_W59-Ui3EZ`8l60;U8j2>MA!D#(B#mfjwEE#9Pkx@AwZ%wc!$B9! zr;asfZght>2>j6Z>5!`-5nCX=nc<|wy`%@SKn@v=dJ*rNG`&>qA&#<#iZOCWcqLpF z2z>2Z`wSK-GduK|?}rms$TO7Kyg3S8xGc{mO;wq{bbev*X0RL0wa6Q%pOV3(l3O#5 z)A@<=WK)e?(GJe?CSVZ2T2|%-7INc%TmN|3zNIMTo_>kH+~3xeVkt_X2z%Ws`eUo= z4wNL~^hgXlnW=oXLfaa`?U(*bCi;{SpGgDXS!K84j}g7LsY@yDs4*qt`iVyyxZXHE zHoM`t6{oJmxT2^%IBO8+oq23nuDe+jP%q!;`RqbIk$Oh=gk*tYZbzB=Rfe_zfGT?B~)hnh11Pg`4=VN~mx?C#SuSanvx-vtZ z_rV~>-cSx8aNO7*nA92oCHWsnTU2Vq`KBD}Ia7rSK5LLgeGroddi4tM8c*WUx_H}vr; zR!?rq*9J=2VmYSMAF6)~6Oxrz_=FwypILQA%Nt5N7tHc_bgEeHS)8B{H5qn#0+3#i z`-F~~)@}OR7jr_@|4MN|@=T-61FuZtR(_?Ino>?&l0cRWg)|QP1JnoHRq7&A4n|?} z^fBd+LqzP@Z-Mrp{7oJ%x!)2sm8raby3rd19DgqO^}y~nS&OsM0aPH(%gnNS^iv?W z)+v@WUH)!!KNwixLdvR{1D5(5_kNJryxRA3`eKQ=ZSNx6?#;euu>l*TDb99ng{_0m zks>3yyCrDy$m??CB1#JVV(RjA@sKj3FTMXxzrWfdkDVadx|!KzM{WyE^AB#)2gq6T zts{k%Zi&3mY+XrA1Ckd-1JuS3odlREM#AT_0ggfG@==#PFJ`!RlT3-i_73I!kl5F7 zU@FcCa6*1NOJQ6D6qvNUk|PQa=O@vJnHyJBB1d`)#79{{OrJjG@U2$BR?i2)P&LMW z6Z}sv_i6gXD#V8w>p#};N`MXx!{){pBd^i- z+5bQ`IT6=ug7cnH9w%}GpqmLLlu~P4^-c_rehk==2lKjBrOe!kS&pH@{_9K-J2LWP z8^7(1lxFVIkm!y#Y-fG@22JLFU3s4$Bsqdmz9wEv@#-453uX6wNN2rARe2h<{tUiR zZc_8mPq*JB)^BEweM0}e{ngV~LAqXJ6Ye3hliZB6ABvzWtEJ=!W&@RV zV^tf4S;$njT^)Aj_fNZXmSr};gT&!Na2iJArka??ItEB%Y3fe|O%KD6SSImOLidee z=fvgZ>(rc0>tkZFbdv~=VHHxlJe~LK@u5i9gE4+xTHM$73IdZ7HaE_DuVULDNhVG; zIqb%WVDTnPz^Y+;v|FbM@QqSNgz`A~pH9j9f`&8+*NwmrKHKeFc>TM$qGnz@8+i8% zh#Nrs!{h_M4v5^2h}`0`$w!F*^TzXaTE}5S(xk*9^~7RcnB#Veu;} z!>oNoL{C`uVI2@on)#D)luytqoKBFD7&A0aV$(@IopqvfF``REc7M!wS?UR1ioL$O z4-R5EXoNKATNeE zgXFjKrI^*6I;SK=7Dl|P;o$K|pP2P*@T}VLk-u<6 zJDVd{)L%TV2x%W??*P6Bx<{ z(*vRNSdYwUG@41DkGzt9AFIyE{Bg~ND*Te+3Z-$ze0_1B6-0@C(S{toZzKGp?3KPo zp7iQ8F1$;W`c579unn22Ry(h;5KJP)D1s*+pyLJGw(*opI=*>eKDH&EsDzOUA`7qq zZWVxvx~0*&Wypff4^ZAv^b3J1?h>06!vQ}KEp8FO`QkvF)|VjHjQ7RdQaC}Yq>2?b zVg;`#mMUN=k^Y~BM^47|L6~w66m7hU_-%Qcu8%PhMH?J{vDcm*rNw38^l(FWUw7~y zXgTcK7)g!ry4X?+50H7ZJO6bWu$ZILZC@vUcrsvrro7RV2;Zm%H>s}WZJ$Q89(Up) zrrVV5pm<7pYMi3o2bxRRDC$rS27U?6z|$meL*gR)Ps^C&!snKLnLq##Mh9*ILvrMt z5TgVGe3JmdGra24Ewpj|_THB52hr zGc8rF%kihU(k`|R1;(lYs{B~b%kr2Na*^A}k_KnnYcct2f5YbwKnq;iYTG6QB|ZKC zCdfm1Qn2|1BlstqJ+-IxeM`!~D9~rb$mu49@|!4Ndf^D2oES!Ysh6vm5ja9!QJ>zG zI=>$N)7Nf?zM>1{7I>J?V*%0BkJW#febLPn_0{5muQq+hQ4S)v@%u?b^vWwO-tUFk zpRyN#LrxMncwPbb4h`VD&yk`ZEJDBRH1hAe`~I*#VzG(bn~~$zJ=^}GY2z9oWFC#& z=XX*!^;dvt6*qtWhS*e3FD(hbiL-pmMm7Gy?)!{4xUMW;LB&NiG!lzaWGT>nt;Lya z$M#(1Hx&oFi~sxuJ%A(b1DEUd+3u4Pp9NdyEZ;dFk5k)BwLdc){X+V9Y@(NnF8wMI z$pMI72D{hmAR(zekh;;sqad+a+M!T(+TROwpTX30G!DcwiO)_FHNSorWy`B1PgW+- z-LpoMiudI-fa8Pk)wX$;%Dpo_%{mkQrk&wXptIn?EeiU%@)(=Mr2Q+opNCS<@U?n9zu|7iADbYobc6$wkfH@<;1CAsXvpKP}062#>kVQQlXGI zPZ%{a1d+$|52QFjw9q|_-2yX3s6_KdLKlhTx()mat(1+9hO_{*QA(I5H44q|Pr}sN zSN(krRQ{6AXOKCY8CWuMsE8S1jPr
M{+S;XmI=GMX!a9Y`@vf2n+@Aop5< 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

_2g`SS@E{rJTr};;Rvvpl$ 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

n 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 literal 0 HcmV?d00001 diff --git "a/assets/\347\250\213\345\272\217\345\221\230\346\212\200\346\234\257\345\234\210\345\255\220.jpg" "b/assets/\347\250\213\345\272\217\345\221\230\346\212\200\346\234\257\345\234\210\345\255\220.jpg" new file mode 100644 index 0000000000000000000000000000000000000000..8561507549010045599938818958855622b45717 GIT binary patch literal 27096 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 literal 0 HcmV?d00001 diff --git a/img.png b/img.png new file mode 100644 index 0000000000000000000000000000000000000000..4f986f7b9599ec4af440919b1a2c00fbec14b6d0 GIT binary patch literal 147043 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 z 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

=)O~*pnquVU22<4Z%> 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 z z^Zq!wnweatS7$zLxf_Tw`mT49r=})m6ag4Aj>o=QTIS*4KW7vW3_%I?0Mz+sct1-- zMWt|TVvHLTxw{xaW?09Ne6cQaoqjd>Fudv;@*{H`9Sz3LHNwQT`t$NyLwvm7B;#R8N@xp{ES`upgG%3cjUDs3{dF`luSn%XWk%sCy%3$g|p zbJvKB@n@Ml1i;jMa3W4;7XK5Wt>L%ax}Rw4jkdBrD`dwGAvrNPZQ*TU=m0%!;Q734 zs{zTDL!})0D);=RLrGZ1lA$<(9;x*onQwc~dNK*ZznUuB*JG482r!X6UAyTec#O2@ zFAeMysB|Wt$t(b{V>4N}-;gWgmw_md`XKCo%o0PfSB%2zsqL7c$b|3pHUI@>W*#Pu z%vXgxSYK$-8d$pCDb1304bq@;3!KSa#D-?}=3dPr1C-5g5J(sR?f+9YJ$IOZ98NTp zNq`gQ?k~T{+sd0#J%hXPQWdr2>k_9RlI=fnnjy9%$F?MwY9wb9@kGn%h{V_?(WwXU}WAHO^j zEmnGx!~?~-BQKlxIEivC5=v8W6B0OW(=6BNzcL!S(Rb*O=13cq9lH;C)v9vBR;Q`Y51HuGu@H z`7GJD+WD6@({7PX%7S;D+-}M32bb^-2>pw_T9HR9rpvweVa*IZpyHA^XHS!)g|D@8 z(iUZ7csJgAR3*8Fw0VFO7OHf{w-Q_|`Wk@{5eY$RAft z^tH$l=g0|Dwxeyi1aI2D?ioEUvAVZSa(4ZO+ypn({K6m2^oS6ij?*R$=pD(*1`STQ zkbnz+5}v4~LIIS@h07o&5L13_js6`yJOYndMh;C#KE9nlp>I(m?_&Va)2nN~n*`Ej z-sl8T(_O>AZwlgYgN6E6Y&nU+qmvRaXx;}#WcfEH^6>g7cwyG8?;6g~6Gc6TUOxve zRuigoVdVA4zzu(!*SOHiJEoY|dtp&u-@FkN?3**hg!Jgc34&Zoqq0T(N!+PC0(si$ z8BQhoritmP1I4*LFB%}yxlve*mzf`+cNjF$=QZ=ay~gTdM8J0g3+@tqsugpJ0hJ%8l+W;EuJ7IiUD=@tK8JoMgcSL2>99)pt zoG>C=+g<(9z02f<*xS09c|@J1cta~HqYw`esr}KdPLNS@NUl#xCxi86e3H%JI4|1v zUu~^ls+!YmfW`OtfXQqm2p}D}_rEDufevMgWcv^Khh?BQG&MOI^!|tY7e_e`Wyf@w za!CVqzZD(c&lv_p;nbIAfadc*qO$zYI$m$2QWq`y`G?EI$rtbY$V3@KgdWsn5j@Xj zn6706ptW|wP~U%|s=BauCa9#KD@jV?V%h-ZsKYI(!iT%EZLs(3*AD1>oo1y3{nqx0 zi;Eu7^wfQ1cKplt*zyrkxK#X)3iCXOZw+t9J;8nYFr#ZdzJZC65ClA^z^KdWWAbgs zLsxD%c*NO<|1os%QYNs)ITQaR|8Y^WXQJ=};n!%l0`G4E=u%=v*c^_>TfsO8A`|9g zQk=!Ai5f`GW3_)+fo7((83S>{?e141bi=(## zbY3H#%QxH&QEd%sU*+MJpS}sHiYudxNFb=D-ZX29|So zFM+=T6l>OJou4)!MO4Jj@dZ=}Av2r}O^S4t`RjEmY9qw^M&m5JNit%4+(lI@m zGCkn|+ELwG4Vl5x!dyJ08pWLGTD|qL!8QgpN!Dyy={bdHT~3(NH)xAY0Jq=~JKf7Q zy8nS6Dgo5gtNuS1fxR|EGWP$N%+4SgT}OJ_tr+jrB);8_CVv>Jc?1?uB)Xb8fqN1bT2)ZiFdZ|NiMa;ma6{CbtsDaZ*Xg|;=1 z9vwQsR>v4&mGue9pw#f~x?{1sB)DL{xT~+6<0MxoIZZJw;=L(8aX34@*w2mzipECU zyE{KEeVwjhW$%*1w9GYzPsV#5zrAIz)oAd>ac&|c7lMci?wQrUN1-cpzPCDXd%q@f~cT`5!q*~|3QwBm=70XIsT zkvwqqtpkeJE(=L#od!MWtd9DEXGX>q#!Izubnl!dH{=06?`qZV;#oh2(!s5O@$&Mj74B9h5=h3 zbL{y=?TYlT{F0Oo`dz1pBI7+4jaoz%CoJDV6msJapRxdJ4 z+SgEe3p5A^2Y)+oxc5f#JX4lp8y-xGena&(F>i=(W#Gc7!7wP&9r0b;)z^5Y?=}mL zdrLGh((_D!%!;N$XyeR5Eh&yikrA~o(rgd-_41_TgY1VqscE!W5rY@MayF`dA}IjH ztbhvEYDzR>!2e5@i7MM^`~L3lzV`zk_AAf)XU?2+W=2m7paUpwT%mc+Tc8~I@{zjh{}TBBwE|<~ z9u6p!L(j3pwM9;IFWM{9H#>N~suih>TDz8&hMWu3cKsQR{p-(*+ArP{(1pTt`k#$7 zZT@<)CBdz?9^7^E?gf*0`zNmzfzq!}_2z3(U4+lOzJB?wd;FCFz`;F)m`xwV$NcR& zjF?h-wn08}HeU6@ow8ZT$FtEcqxnSW>FaTN1Ap*WXvGPK#5c7@eSw0Y)>IkRueFfJ zqshO9gipep$lV)7FW+ggxl0-IN5<*Ps|PG{9_7n-dI)FA~Bx2YMB2! zs0~7EO0^$+%8XcZtGfHCt$Ak29=PVuDoQ+XHQV)tPq*>$?7*)9++BmQqxB1dGPzRw zs}D{NvnA|16H+tv446HPMv3K&>G{bxfA*OiRdmzDySH`@Hr#HZ;#)@iPB-sf)09~C zFI^m&RyyYcn4rwxSE{>rL{wmSnIQ3}qQdkyTtLcuZJn`gGE{&jn3jh=j*z7D?=O{a zxax7n07BF5Aslb`0Uh)_K+=YTc((I9v9XZ*$i3kqM3})^2`QCkDM!xf0G4ErNWB{Xp!Jeaiba^#pn9jfR zfyU%omlb>Ml5#oQrJ|dR=6bQwDZ=UaAsL!-ic0IS^hM8XiS-3L-lTblQdCDk>6erb z9h&?nZ)~}Q7wnpFmkp1G%#Wq4{(W0Hd5+`O*>kY>uls|v)wRNQ>zTRvc+=jM?#$H> zxxp`i<*kEee7|1Id?|`RftATyBM^p2Wwqluk=<5bnX(u4_A-@>y-8Zz4Zao?9pZwf z^H**5zwz*4GQ_Ss!A4|>z00J1@JKP*`N8SEcIXQ}rkiusW30L9g$(b&R|NAfqfkV6 zEgk#5`l27zod?;SiNX6N{SUclGcU4D{Pf{RPf(2_Op9T21=N59#HHHdh7c$cr?RJm zp!i~dcagBX)^9L@52C{&fp|JO($68l^reyjJ_sp+P8G{O&n)y+FteOBJfU zZ8mw2=_axs%H+9r9zva7+6OAiR z`Yf~C4#38ffkS8bzDzIr=Upw>vLr)xMD8;*g$c~heV-#B@!00PVQ`cGbH+fAXJ(XY zsIX?n{4eJcL~uVi$&}GB%P=>l(2~PMsui3dtz`?xQ+$<6?U`n$f$Ahx!|t==2M;GQ za?iEEsHz4897@e~=9LNJLVA3SZRJB~#pmZ$r+b>Sf-mGxXXr7Rb0H;-Cve!tvYhW# zW%h#2MlEcjpAvvV6Ut_kV0fY9B=y5sE})NR;>D4Ct6T7d|FV2rQ!ul6`D{-SpRdRD zKg;m!KuP}_;yO=9jOit#?mQ-GuWVuBZ2ZMxCs8)LiKNddS=;3x5PYKc_~a@uxy{0P*wFQ<+j2FG$hC2@1_`h92Ya&MPF7{=JCQC9g{$hJzFDU zTOcQY^-PxY6+KCF9QoqnGZOdYFK~hrH9a&5KK@TTN z>$j>1M9k(rQC_VHNJ>Ig__HZf?w_Ja83C$c(vBfq7@Mp#6|I!&!}lWOF-Z(PiOnSI zW`1E>B(zZ63hzOGvETFYtl-LlYww5E>%;mq1YU%uOJRbYyt>H-ED~WQE=`GlC0UZX z-+sQJWgS&#<&&1vB(Q%5e|3=Gr%kA0WPz-*2d92HQZg&f*ndN|2?@>;I%dDTMC4#0 zbbA1Af!J>B$6WI5TUxQ-xvZ+o`04UgJNi_E3k%(tH%}O{;-cETI3!~iss;=GW1shh71a*cS4nJTJ_$(QP2IHAIAsg zkB4ED0liqkUC59Di!8h4&ON}}=VNUkRntHIo()l_XMl})Xt5&%eP)6Wn2_KsJwp8k z*&zJJr30&}tzX<-hP{CT3QI6BIssDdQJKr{*CeMV?2)8)UDcy~6Z$2|GbQ^+k!sE;x7Ofkv z$m%z)X4&-{0`Al-+RnhOP^LG5xyuuYpl8i~%+?k=T}gAj6W)7xV`&RQZIdyyp9O8_ zc4wU}s}Q2bKfk}qv@3BL?8*OCT@g5~`LkFE6{x{WRr|KG(KcfM4nui9_F8_!+X`4ZSMW?P%KVZR7enah-n)$~!gen4X0^{@m2j z(f`&4gY)~b<-+13Z{6&txU73m!JI*t#txr8YXCzgLJ$w|Ff{d~X!LTQBH#>2s$f5@?mLZTP)0BCfi#%u7!lb<;f%rVIfUE<)}xn5|H z_bfyE1>yUo`3HkjUB%C=(VLqtHHQE46VrD_q-5p^cskr1I?|oLWh0hsV^DAU;ina9 zvGr`;ZNK5;4XL$Qjd>xg7!Znt`LVr{C*~rsR-+2Zt7i-@m9x8^P02e!6^s#8y1*g> zla(^&9mw1T!gN{QIq`Q?ec;+ZSq+&9(hNU&N3YXL#_`VFXIsfti|gLVJp>h15*iIa zVPA2cZP?d9-|*i`i%6hBc_TDhib5cik}W>3CplteO>heEVr7qk&_%(JkHw&yCE{^! z0YYH*7iASJ@4+dc?uZtpDnaHcIQ_3WRNB#v- z@9oKTafHVmL80^WSE(g;PLiQVcyaSu$0PmN6>z!*5BKJl#~Xf1;j*7g?6&9Kg>p{q zGJU*}y21l>{{};cits>#8IMRvwBHE*( zdb^!Yx1V2sU^*`!^1I)+wNEBZbO?6jie@v|!TB&n-EXF={0EeSC{wD?BpU30yr4_v zWuz_ekWV82aG!_$Z(V*~1;Uh56yHq7=500H@z0ZjrfLYKH@ETq(GCl<@Oue3Dw7-P zamgxMVfH3|H(|xRCSE)8r?b0k2s+G0GYMW2)8cKHTElE_Gszj#asC^YyfZk>GpTkqPjZ@en zbOrZ`n{0g1q^th;OdRKBBasTO0WDi9^Ik#*DzN)XM>S(jIWq7es(9L@_``RUxFccE z=OEnLF6DD6o$vwM>~+$`r)MG-oI${#2D9RhEO8i=IMs~Vf%dp!^!`WJVbzj3U%D6} zc{2M_<`yth+jSiJ7_Ut#5cEyrS^jt)=|(^VA|y2Q((*c(l(sR3+C-5{W}JgHYeV(|f9H{Jbp-59tXw01K)p zB}a6%aOk9q{$G0{pza=O`m$9B3zgO$9RktVilB_~Wkif?r1+$t1Qgxj2+I4%(GOZJ z{yrL){Ch{H)*wZ^qr|=m(>P9+TaY{#onk*`-Po1-y)O_PQnE+e)~E~PdeBLGdHD@W zG7j?_En6Ac3%pL}?%xW$B;S!}klDwj?%%vS9ed2sI-Gnn&YW7SyL8dT=*=h>@wQht zf9;1o`*}iz+Y7Gy{H|S9WsiQk^?i@m5lwo&`#rO<5Po`u(sjfw3vOokGHjN?g=1sL zWm@=!MYtFCaRfzW75m^flniA{|Kw> zx+2yQx{9R1&otvztX%jHiSW2Zx(kFwX?aLxr39m)NMhbVvLZ3a{h5{oLy4=3ty86E z1=Ekuu3i+DGuJZ{Er>8qZNFVq)ea`nxMr5^{t!swakVQqgM>G{Xr?yC0}IYHBvu={ zV+W?`CB0Uq1uYumkEjLXlk0=M7)<*`JZ_)y&+ITPF7GDUBnr(~&Ma=PL<5Nm224y@ z>IDjJ1#FzUbrG$tYXxQpgQwo(HDrLqa%0UuTN)exEl_^TpQO2`Xz`Z`f~%7aBNgxi& z{q*Tms7DlcnTzW3v13-N5AztaZ1T+-6C$IPA~S?J;Wk-eIPjR_v!GQMbs(|b*!Bgt zfZ)e@5n7hxY;iiG);iwx@M{G1Z^1jjp<83geJloVJoH6CWEP!C4kZy5?|zWN!--ah zezn-RugDIK4?=@^SW*JP!aytnrQIe*)sSxhps3$~>LkoTn1}qPja1`hmXv^vE7ZX} zG~+*b$O0eW#+HK9L8UN1PE2z&csB5mLPl^NSs5C?3=#6U>`(T-Vr%1kp)hsFV4b?a z{4qHDG(Rx;1sZw_y_q+?oO*oxvX@z|OFw}B%>W}OAgQwyno|JGWd_GGwhA&-$bwz->n%6|MLDAYq|bwOzxUG@qz->^FvhDe1zjO_waEPY)+Am;Gf z3nEM@=L+lx?b?}ljAVE84mZ~Afw=&>druIA`Cw(y91Jsdo25eR-@MEr^Mg>AlR{@2 zB3jjwZ6A1n?)4vz1~e*ZXSR*S@CSYVvhTs+I^RXm*2Z4LYyB{L2^v^+`8nyYOc4Z6B~bp(o49tTr`P(4V%KorQJ z&MOdOe(iAcnX{KI!zyAVoFN=w({uoAga9Qp4P!uy!lC&(8D3-OD!AJ2``%={+%`Vhw>*GZ#g zMPx`}NzuLfI$D_D*eeW8+TWnXV~CBX#@7Ho$vnQ0(WbAd0uP3<66-5 zrJsdDx-+qd403U@yIq*^Za`CkOtL-S=RiRZ3I^@!-jgr7DRj17CBG<6ZmUaH&fT5& z_XVak_T}485aw=jo%O+k9$Wpc$6kC^W&K>k?GpQDV*fUFLgTh>6qe}2BU{;TUEO87 zmx5uHUdzw;bM+H~x29ff{@|E6@`w49Jnfo${rcR_l&_Be+4rPE0m+7(JR4QgF`XYD zArho-+AR~AnL`p7`RMfDl&P9q3GW~?I0I~7n%~c?bFzC-%Jglzy0TzaSqApp8?MWz z^?f8j?unrztDH0g3!S)~;*Gv)=bXX2xBxFYpYmraZ+WQAsl}H!K14`1*%R}wdq|}B zc~J!ro1%I0=Y|5LJA)7XBEQ{`l9wq-o8}Z6vKOpgn6y2UPGXqFD#e#)Ijxv=1eKl%md)?>5Mlc%33oi8A>bSJ=ifP9(SN-vDmY0UqiGyI z7a;{75(sexPNY&QTvTg#)cQt$P9V63gM(yeZ1>jVb>-i44*;_tEEm>S!g+kK>-;C$ z6RP`2^uD!_QWl5rjq>OIPDB)@b0_M$946#^=uFrdu*J_&1}=7_LkQgepJ)v4A&lK zpXoMqb>*zgUMbSiyxi-VcP4k1UwdGzfWLJ+Fe{(k8pLSLs1Q{ub80g@Lh1bUsak3y zJfIas3S|e)1WY8OhQ{f`=-eY+4ZSVT<3P%n+(h^6Ahr()6|Ejs5CZw$auqOC3@ZeJ zqTo#wQHLKXr3gK6R{c~AUr58aJO;azYJy_`q%Q)%(n4`cz{_?z`x>q_1J~M&gjO@4XcL`&Eo}WN*W$*~=M(!9t_Ez)N z=T7e*KDap-cS}FFrt^zaIzIn9ep#`(P06p|iC-B`$kwzuRS6BnJ6&RH~+IF?&?#PSfWD?7D6Qv(>;PsG7%4dTFrDr;of3Bn$L>% zPmr17>y@E6!O2e>O%zHIv#UJoU-~Vv*lY+*}5IMfo*fQF92N#dl(oLJV2GAVsK|D81D zZW&Y7(n5IusR;uNdmW+vwO$h$9=gw@q7u>x=hlM4A=_;pQ>lWYP4;a%Rb z@rg=RR>|2G`yKDE!*(7al5>G%k>_MSy|ou#2la!J1x zN#da3SGRi=h>MpF;zFivbfQj!N}_SCJ&*9ng9kGx!M8KF**aQUgqRY4R7j>EKZlR2c7WkLZojlpibN2PEJ=yN6_aqgOT61p4!)rGa zs(KaS(9r%9`4SFbLIdfsKP>tzuUDY)6u_qbZi%zpr9%v#h5sck*ZMNVNzne}%a3*0 z7ohjQKlCgH=h|NlJe8~{BZ%qWoNuinz8bH!-D=_8w$MwaWbE;FF3PViKs=`+|2O84 z*NF(9%BET2jAp^ig8rH=uJhyfWU~?tq}|xWA1E0`!a7jGAkz|C0@q z(d_uf*KsC)auPWhIoVTAnw#Wc3G`lwowcN-0%(bgc5nO>@>4;c-lDfSSw<8%S|zZN zzxMe)G!fjd$$1|KrRLHAUS|CG#|{@8Z2BMGgqJjUfHP<)HXo;GBU9)@pjj3KT8%z-r*p|xi9|INNIHw&zi)Y%wPB6%Y*RtH+-gNZE#L4 zqpfA)*V6{j%aozClReSDcy!=cq{3^O$M4_K#GJ2lclUf}6=SFI_gAgD#fnZ8=3um^ zJ`v_)m=x{MqckB^=$neIT;+LXs`mSO5fwv7Fxndg+6EzP(XXJS_)Z)vhV8n zDyrE=aQ+x%_+O^|k87K&s~}w=cfT)^77Ie1I1lorBh#apv~5ySGF}-3(-G3X?fdy# zHA#f}`;072B6j`aZxtgWV!{ntb?v`w@+^46B9(9gE?dsZ@pG8s>bL0nWRjLvxsBQ* z1xcyZY?5 zkm15V9EP9TO*H%d?axBmIe_OoksP(Tb~< zZ18t>YC`DnM=Gj5NAsWYi&4?^De^ur4Y=p&-BB#@*+$in%q3CULFH=-^G1BmlDgPR z)JIM>gg_&Ui2-dw4`pSRxqEkX*~6a#T9~CwZw3pMLE8X%es5GStXMd=JM`seJjGo8# zsB!t?$c1Q@RZjFKg#tyPG7FCwVchWb$*sddV5k3*!+EOTmGrQW54-J|N?tDRvOH75 zL2gnEm+9SapY%oH5QdiZE!G-&y{ik>S5UDqXd7}oHu{}rO|4jdYb#`ScDAOuugOi( z(2x=zA3x>cLRyYa=2Lsdca8_{U(4BPij^53pu{04oDSL;P$V^yq%f+HdtgvCl?Q^u zem$I;zkhNP#v-nhfrF2=X|Tg%)yl#^NII!6qzT;errg73Pm&MRfg0y~_QX4uXSg1VlYHBIf$_Di$(1WU3Ynz9&yT&w z7EKYSdxH7z%m>B{^9x%EGB*Rn3^Q$Xyg){0D|VK;AgbD|iiX$3EmdMa%f#(`v_z=x zui2Za&=tM@ZvSJ6SZwukKCc9AVh^pe$X2RWj4Q^#xQ6@KB z+oi7v{%>)eOPk6id%_Etsz*OdMDnBsC~zvBdtOe| zej=;pXV=rWQa^kT-@^+HyJ|?zd+P%GFzp9ze5GWSMgLR3O*qZbB>Q1O;ZZotC^gY{ z^<$H?p=|mnX#1D_cjq9^>l15{m)E`UmmeZChEM@*sl~r^P_}8rMH9$k&fwUhN07{u z4BKUIa;nT1_sQ^=TjTaU1FuaQJXoIm zdZz;Z!^3%JIATu&90$mek&z8ejiSe*c^7eB@dfjnXmfKTn%>N z`>!MAmAmZr;`UKO*rnsC3xRA&NH+OVdOX`>Q9l#{FBJcIFh%qA&AJg01O)66hNB+_ zSQYf^g+oECx4PptV!;X$z5Vddd%0X|kgStM?uW^UMf4+AV4)6!tw;b;8|PWIIukIA zn+4>V`vG4=c0ud!qKR@tlU$9<@v-r3900Vq{_a(nuEJ*W#3xwTZd{V832Gz(jKM8i z6%7je&^Nnty$8KQ6<_L^zxBPd_Wnll+Q}{Na8#V1;;sQ8tW{4&O67N{Lco|)F@4rX4q!4U-^q4pY*&f9*9H9F%~4yRq3ZwMklo(*hf0v zQ+-u*YmoW+xV7@DY68w{TNBe<^z%Q7=K+R1r-FTImR1yI1f7))oWwGL_bT%4lm0Lh zt*|u{)F~90Mn&ZD32sQ zbNt0w;-c9*Hu;3#WRb~XypT!m7a7=l&gNu+xSu8Pq`lk}vb%jCFTaocrXY#+ zC~t9pD%{k!Fyk!RD>bjhZ}!>7j9UjMx+gRD#*uS*Tu-~dI9}IhkoJZLp6&KfTL*;+ zu;0?(e}>uo`>itQ!js>m0tH}dp8gq{nc0!BlW@PV-uz=dK8s}>6~n9G72g12q!oa{|o7yI`NU}qhe|@MOji^nWP2e z{XQj>BH=u)e|)n4(OplBpT>J;rDW}uUQv^E19jrHUu7Y$5qBBt8rP3MvI92B&_LkR z8aWb)QO{IJP)H{7d6@;c8^b=Sz~BdiTK|I3!W2W|kCXw7El>te0gw;CfWI&T0>l7Q zlMuZg0GSMSNG3%+2plXCE354llo`%lx5W=F6ODD;Y<2?_WBPW_JhCGt&S2NDW8C+k6GO6R=&3M#Mt1kAv<7F^0 zi+m?W^r)t+Sci?kh#DNLg2x#LOHE{>&4wF7lO?73BTx04N~xEb0&EgZl{h{u9KI+Buv?9glgcUz+Sxm=LpSvwb5&(i;0`+OY$@)VHDIf2A@9ME7Tj~r_fngZJsqG)dqR~N( zTtEzn1{kQew-NascOIIk4rF`>d%>~F>uV5N4yb+NT?xbfP{GAAlODS*I7>IH!gKDm zU^EtbJaZNMfeW{u=6 zYz0SWxEF>8oSwC#NKEg%+)wNmcS4Sz&4%Sf-xteBaWpY_H86m?LiYZ1JAB0pync-#Qfd@Pn_L=zh&UTLCNuI8jKOEp$#b8~F>kWWJuyKt;Kx8!Ey zNs|zB!j>o;Tvhp1fI#I%8{GGf;>*`cJ>3hSjQmzJ^9ts{e23><#;mw}&N7fT(aId2 z=0IfTSz}`OKDOZ8=2Mg(va^er#o>lBon!h@mJTeKj`!YU8_gsvnb?eXOBeaAZ;9|< zhiF)zra01wI!@S{r~o1sOSu1WTq$AZmA9DD8~f8^oo5!+VC&uaWG|<|h3_Y>tU+FT zw{o^8C#Q3yNZ-`~%G5s{zdlGd9{qePs>q=8K|0F4|M2eLdv_?nARpw10DN|5cmSI} zMcO9yZj44{7I8fZ)b?{N{#hdSxKq>9`qtJY2|eKS{>V?=?2C9=!?V#zW4JY9fAhb5 z$wcK*y?kj1^`V3UtHmYUQH8HqFt0{f$>RxLasM2Qlp05pfsd--6Zgn$#kv#lfnW>n zQTbgD-}mvcdPG%tfaeJ*mW#22-&>AQ7DVrZyDP3f^k99D6XYpW8VJM&L@q9b7q1Bb zK6vwW=SEpkg;E7OYMuS*U2LJ;$_1fqG5FvT0E1w2ycK;Fd8rfC)m`cF?j94VnGl$& zbYi=Ey?31dfLI1}2LinU((?qQrJzH9 z!~VLC#Uq%w0MF~(yQEOpgHWscKt<^=KRs|Ae^RFj)R9RAoz*c3Xmo&2RXF?(ikykhNnMXK4}9x&KWmB7OC=f4 z!^6d$MPd>d?EDHBsjS^uMvNBZrkRW*^^V=L(HYH0@__N!FG+82?W)XE>S5mOubx)g z7WXY}-%$K4(}@t#;cGL_Yi47;wphoUDb=#TUv6|{>61nH8^$@84=CFEi2X~AQfL*U z)mpFga!sr7dO+G{W*8->rBzWPk5_7%KjiuW@zGQH>%8(Omu7CMgkR_1%?F{raB zDeAYqEUUO%mLXkK<3KVJox(Mc)2xoJ_9a51;GVQH}|gw5EuYCb5});1}*#$YNud9TQ>V>NCEF9 zNTNZR0_M>dM{D-~e!h+H2Pi2ih2Q@YrWrvnGDe(I?W)Yj*Nt(4(E(y)@KK3TIJ~&5 zF7IpAtGs-_Ap*V5e)K>7tfLXzdqt$cCrnlj5C!-YLn06E|EB@hze{+%KRNRa{ROlW1S z0suq39mT28_6CXNYk7k*R6)M+2$Y=k)H~(0fAZmqZtLQYuK&x;1zO(+&M93b0q)m; zEJdvQeC=-9KB4T#-jx0M;0s(`>$}LVYr0%d-((Gf`MhbGZN`gi zfLv~Wqy2_J{^rPf!Bv5{ALQmN8f~xfl3`4o44u(aFq@5*tR=5u5)_V%LC(!nTfp;%Ydo(%aW^52|DMrMo2r--gLe-(Ol^RFVwc4V+=qy6q=-o4x!PJ1hSga^0W) zd8ySFtM?H#`|OdJUA2OzCcL`dv!Fp}73`no-E{~t44uxUd&^IVd9i%M&eZI?$Mh32 z(ePr~h6!8!o($#)d<998pu2$8)m3gmK~;U*R2sY)xl;0-ol@te156D){T3eJqG#E) z=P&g@iHCnxg`3<8Eel37fYB^M02grRfy71ggV7}`aGnDpsfUEaiz5n7y*zfX%SJX4 z#i}N$W%-07fCh|P8rpwTo@}#a?Q=)4m8)Xqb3stwzJjx`BCm2zd9Y@V1F(OyCJV+T z!UB!+=G1lF?gm|j&htupeM^%B1 zEr9qKh7IiqIiP_^mx?;?Qf^FQ#v~dHp{8@}1GBm^N2}5XphiM0E|9szn`xtZ2I(i( zjSBQfF;+lXdjpx18f*^7xt6H0R|Z#LbW6Y+C%X6^jWnqum%za_$`|ZBC&44 zb1z~NVfLWPV3`M9fP;9o#FRG(6{QJ5XVTC3GqZKo# zv~1Df$5e-j8>}Qq3DLJmB-ZuBGzkSJc~YUkV&6kTrGS=Mb2QT+6VB9i zDCupPUgN{>8831d(n;>(2fqhB+?S3EscUvN=$^fMRPf1Mkl-O3V&MZ5HTNN9Bn&MB zDe43AxB!F~r~!;Rz=}c090&#v?MaOSqpAFfQO1cBU>m@O1m&w$3kP}o)(u^qG@ei2 z2uJ{ruwBsqMU$Qf9T*_b09>((Dd?bDZYEBYCo5`|*j*er8uvT=#{~j}o}Q5dGyVto z^CxoOmyH!{PYbO^1x-Bo_5=Vx?ovbffk9H;AsxkvaehM$@oE(15EmC4<_C^+DOJ8K zNM|P|79cV`=ujsnPntJ6!(or`l6jv4DvNeK{yye zw;rP&5TxJ2teJkDe{`g1RuMz9l+L8RluH%AyTnexp^~S^91+egQ1pf)kDU!yg-4pA z`-|Q~BU8aRHT_RAnk#hhESYbsLldRby$d(KstnZ@>J>70x33+W@pSv!;s`R!er&W;Q4vr1nMi-DsShN6e(Gk{66jDIiNxLaK$Zf7gBN8Gh zk|GBogcIU#i|E}C{jCxCzW$lY1eAPE~Bn9-W zj3U$QMC0+j^qqe*5kd&TC}{}l6#xj{*<)ve;G~S8D054PyYz;%A4deM&A8 zGGj88+Zl2w3GUW_@B5&2cETr+zULYP{;B@J-wdDkUUdp1<%1YE;R0{cSa<@$-Y30N zQJE-6Sr5?x;I)SWc1lVbGqoPozMY>2*M&KM{P^?q9^*Ezvw@Yz>N_72l5VIgqL4%6 z_bcQUAEB*PSzkfdgd*(uQ%@k%q;oinS{Ei80}t0vSE4dj74uvUSN@G6V?1w5|K904 zU~+vGddGZTez$iQL6a;J`#3SiWhPhnVp(BP=+D22-t$eQ0U+|AefmcwBc71enaG3a!hNpnmErV(;2m+|ZDU_9vN zuW?qR4XuleQ-0+~7}3rLXXmFX!CvGp^qV+P0|R5sBmL;ZL%WPjs)7c|TmXYLvit>b zR~)zSz-h{YC>`t+NQU|?Igmo5ndvP|cpO5jZZO&TZ$*ZOG`aNUYs7(bX|r?9veZlb zZ8-FM@O@l+`3oB6&|?<)%Y6vTlKr}U8|8cci{z)F=Wp5Jmd-y z?~fduTe3-Y!kMWD^1+nPtuKtCB8A;RKUc#ZNuYKOB-cT)ng8jCvw&Rn8C%mi&$ZKbe7LgOj=!{09jmxw)^MOm!(a2 z{*zcYf@<|MV4rVX{WZXkBn0>$xtlADjL$a(l9W%js^=d4i$@a-TG=`6Dd|)B-42tN znAbqXO#`xChV&77go$wCs|Hh%v9WF}ykd9#K}{MK7E5rb=2HBQ*nAN za(YVaQT<(P&Mgi=P+%{^vZ6!vEYp@r}tb)}N&7#R`vPJBdc?L{=r zsFULM#f^7lFhqUdRv&eW{1~fTSdFBMMi>Vje#SOXH+Q!Lw`-wS*4Ps>7rqa(9AHX{ zVgXb1l>rB=RY~pLI8_C?a)HvQm!;2(pSwMHZqN30Yg5nkaa6n}!GJ&^H(xrCSB#{_ zxtQ!5{Dop#165#~4-6uC+khCNjN~(wSiy-+Zvhz0*Zf)>!mb8ruhIx|mu~`W7pt4C zHz62}08-E{{BbjD_aM##C>|kxN1NbrBVVVO+tQtVg9Iv;I<7f`I)&yRTL73nRu%O~ zG_OPZKPpclrH3XI5(fshZ{IB6brN91<+e=w_v+Vg*Br4ncDi3xAWXRh7FA%KDUw??o?o;oMieh=JJC?&j z{#L{`mKgs5H=h5q6#R`Q)OmWJYip}=TJAs(&SQB-g2X@U-LOm4=V8qFFG`SnTY+3z zeB1BgIa;ez^2JqQ(%aqLp%`2?t^sP=MHhDRho7RKrZN;ozbz@N`h*gDlBQC0gnE(% zd-n^kp!(fpR$@Sv&Ul$=LOF40)cbn3Hu9izenU?#za!Vr+lv6Ed;|N$=dCB*Pr!uN zvV=B7(0B>7{hj7AC)IX&AO4!Byv{%Sjel7uM({s5L&mZ#b9q`@{2QJFYz z(vLo^$iL2*Wd0Y$J{6arqn;+Agc+2OxXGW^Ydj#C=S@T_FC$m&-G_1XnodZ~Nkegf zZmQkTeh7vIYt`e%!!`;FP^^91fdqYz9GgT4fdLa6CM@aA#RX7#82>OB20iiyQFsBK zIKV^tZE)X5v}=V+581)x(N#C1Z@kZ4{L0$&{}C4h;w@wgj}srZuC+p;yHE-Cu$l9-Wv<`R0{bncKjmnlO9rQKYPE}J|aWi zZZu#-Jmw3+c#xnyU7z2WL(qqnC&ABdyc~f9q22@2_18_oD(j6w$;(F!2~Kc5i?cDe zK&pVcbv3epItJ5qDGSVhzPUAw!D?X(Ek{VmNEkctZ}8&o-1Xvs!ET~4kYuxI?PJwT z+^^=%`m-}ho8OHLB*aLeqxl6zbgQo^xvMh@YHHv;Jx{O+ZtzDqk1-xZog+-@=?f^J z|A^IwED)p!2RdHyPkX5F(EUmPrW(`$)zbh<1`?EN zWAC{7@z7*IjTt-OT%HD?jzP}+Jz`+=+u2`GKWpOO`wM5?O&5dB(gC-k{}TvS>4*V- z$pJki)d%0wz%%9r7RLL&R*2ERg(aIwb}!^wj3$1m8-mQ^YiAQDd0 z4cc$vwYhW;c7JD~@`O**Mf4ga+2p0kW{Dh4?gdKUFE>cRy@;c-eqpB9LUMhbAskh8A%9C3GI!m2?vyPbjPLcP zgvts%komOOWmownxe`kB>n6RvzBz%GAqNO0rKvedpcfk+E}QjBij~l2Kto9|5Y)hv zl1-TPnv4g6D#m7fg7C0bfW1nS3FX4>yOyqmed;ztC z-Z&!+|MfOyN@?ig<(j$awIhH)AbYVR-v~Wc2-@S$%Y31uAAJvq#Ropn5by&w6)?0I zZr1GGNdzT;wPvL$0gZNK$UvZpPILIrqqy2{ZxYVlf?mz{&TsDLF8)8bssA5s^Y!+D zZ|Pi2vd7}EeRj(o97eLIVr@tmKR zbo|VDT2QjfZQ49uZplR&e39!pK?FmmB2jUzyi{3-;zHJKbQA$pHg%n*4W>U$M=A52 ze&i@P9T+bib4;b=JWtCBJUYgy zsClTS;zi9%Kdtw7B3=^&oKzSX=eHCv6gqNna{}DF_wrE(;1wEnAO%|(UC`WM;0qn< z5bNeww*si94JHYY;+y&!lQ#u3?pf4mCD1)6ccuc#rR^|vr~A(Bo7vk(+tzj0N-^EJ z=8yzAn!B||fZ^^9C*&TWUU`SIz2Vyp-KxZ>;5y>lQ1DM$fRG>{5TF5+$&rholt3UB zio!+PErPNnTDAQGDYimCjkVv=hLYcr{_oT9_q_fEYdXQcyG&oxLEl{2-ZrnbN>?k! zu@yC2)d09znpp9th(^?)Q7A*&C~xcLXac6>oc#lesd^q*|S>4J0Vle;zY45wDn(DfCS3*D_K{^O1O+Y#-2%?nGn@SPs zT@(~41_6SNTrRo*+vpQa}ufbT-p0S>{ z4?5FhjW4+8mchr1cZuUmk8pY6UL-VO*)lVj>QWNKSEcOf7RTrDIYwwLs$ZQsuFAdH zI}>+Ym67>fwO2?m(X(6Dk4~~vS=4g@IxIpBIOMu%YB7YvUK?E(gLr5&HI%<9#)&qi zI-IeTd*A#pmrREUMvS6UTtm1Yxce25wsQIAN8hZIrB+32BodzFKza5sj;xr&1-Gee73>o zn2c^Bc`(`Ob6GJxG8yrV(Jm_>{fo+Wf78s^RHaLXdFf(7sNL zUrY+Q$h@SWU6=KBCj-;m3j+;)GTe1D@4oa<8&Czntc;Au5C#{IwdcJyHZu;1FEtTE z8KuO)y`?V*a-Fm-q|t>kYP6T=V!1;bcf+QUtdqD=dQklpfBL|X z8)Qx*yiC4#sX6G9u6<4p#dpB6tmg-aM`;|O;~!vpuR^$h5UtS!#qu@^e7S?ZL4$+h z1Q3cr)pktm07_VxgDO(lJCzU-20+Sk*7P1=0v{JW8sBOh`gw+|W+M|Aw6eJpP(uE9 z`*$)5O38&>uF;H0cI2laj-lBbT!Sk+8(lB0?VMbhrq7r=?Wbn#tVMU8^x4$$2 z`6A!*?HN{CuLIfGsz1l> zxH<)z&CgLJ8L6pS<9dJ+q*p4vc5mw=SH3Mp@#eSdjb8>r*7i6o=2DG~PlUn{ATjw> zdAY@5s>!#v;^Sf7TBiv%4E*|VVHunpi-j~Dn;np*+u+Nm{SMLE!%SCkQ+B|K0~gOq zNPzL1($VQU$@tUknB50I&3tzyBC+(~A;T3A!Ha-!d6V+RxpCu&2VjGOK~Sm7r1&b9 z28@$u4&%nxP&n5-F8y-D+pp@%*1cAB)XPc0YCKhk8A2HIjueHB$2$e8RB|6cC_s$*f%E!)sZhT20 zYCl3un>BwS2(}&I)7TIRIe=Cz0nI~@L-j2e5We9mX2`jU^?>)- zCdZtS;AC}3=RmjhbJ(|_!ch)^$|TIayj``XG0Mv!oNTqM3-~i=d*43BA@y zJcO)d!&CID7cD1ueTAx&qxT9Z ze+=EFt1{?BIf0XkM=hTtW0@{YbUhA%Pa5Ima%CQ$fNP^*z>k`(2GG++7~y&-_$tAj zsD1n46O4yUXlNKNA`>Sll8`ToG z&`d${BS`LAqNppvjFw>CYM}dydsDpP$XV_F6ZQ}Ezw!ka>~illRFjkb-DHb$@*SlI z#pn`tztDUOl}3ssBRhvi@S8x|(w)+i5*`89-Y8pd98cB+VIlJxp7|W)8sd@^&@E0fQ&4j2$F<~q>}m-d zUOFX{$^f~ZekD#v;PpW4rLK?yEFEy(Ci=h~Zi>>=fq^|pp*WZ+FEWu(m`>;_x zu;Pz6c{uJ89Otk6_#Mx+#XXneNw@j!>j&%qi2^w!8o&T_@o;tP?#lE&#j`MOcuU{% z7*aX9KK`MCNnr5Z1JX+AIboHq#`Vh5b6T@H;(3?($#Z_q_WO(_95C=>fi4<=!12%!BN zUFg8+sd$K+-8oE6%ZRfAxDbG2g@0v(?(u+)mv+m7R(}3SVsao}PSB!c2P;j|0Q@zS ztTokDS;gHLDB*U5f+3BaJwiza1T-I12T=fB>DQ{ZO>rREZvnZaSvv3qx}`W}#P~7Q zp{*aN11YP1(z;Je|KM`x|Ku2)e7usnQ9R~iKlidS(3G6!Lq{mLRC?H|l&vRk6_iaC zmN#5^I9j{7SeL&GO_b!u@rs6Hzqx^(Dn+HQUU1`hB+2VGr62;rUTTmS2(r|ei2snz ztp_wNcl^_7Z8Y{xYz?$?0dYl?LtGv#^Ca3h#CVR*VKNT73PCX^^{#X<4m+|z(`p?CZkVpb9zqWeyYYt> zU=PdE&SP_6MqxITE{JIJ`-8KHlWY`5tvDz#`slS%C{PV74ANleo3Q6$PfZ@^?hQ3~ zXXDJ~t5xk2h}rp+|FKb#hH^OH4?&*s=rPrs4V`}xwICEihz1rspY(=jM)74iG9L{p+7D>VTB7rkzHIOsx<>wuFEIJ#`IQjNvg?~j=Fd@T3gK#MIAqj z9CrasX*^_6@cp<7$K!C#X=1t7Iv))fJitp$P==aF_0aYB)j3g%->W z9>{b7S82WGjp@@1-%6;mXSrPrlT6mKn+|r*nHJWJ4f*^R7LqY{C8TXQG*zlCEwDF4 zyLF?ra70GyuTewk%|qu@Ak*@=N66*RG^D#zkm7MIIt{b+}~kn)%&r8KLrQAy-% zKNIqm3ccb3z@LOzs~))!hvW~1eQDm(sBNW=72toTv%uEO>L9g+Ig5t!7W1)f6UkPn z^_G`Igh2f4`NpTj1v1}Z@SzDEcOb(6;?DsN7Qn{y&KTl|zmsALu%AK12&FlGXL+>3 zz?meWhYh@FolH6yognx9yAvW_6+5)Oq7OLw;yADk6P3xe(%O{wyOpl_54p-CLS|t<3S$MV;U$y#AIZkOz)mL5f>Z-w^lK1{Ao~b-+LF zyVwCm0V93-4c?>NiQ?g~YB?i4`oz>jdJ{4YQ7*{dB3{)AwusbN$+HrwR8HQmv^$r>P zf<+pjAHrCKWN=?XViH!5z`sn|06KUejhX`!++yKcKe1xPpelaFU_vID)Mo9;4v)P@ zF<8aM9e6STJsYyiBAHPm*A)l}1GA|Q1QAs`09+_t_)&3kaK04w4S6?}@+w00U)K`( zN%Nto_(Oyy&)t>r2N7CnBkK#VU2dCu=*)#}yOl1Eap3vv%%H7~s?BV{kM-prl~s`k zSds}pZj36}Ui&@}KH;Dm^5fAn*{pQ%{7@qlo@S+Adn|hL+S^;@TW}$M!&P{uHh(yb zUyN-K%1l=iM4g>w0n=-U|;mFkMx*< zVmW)>#h-H@;GKPneEO1el1uM(zC4+%oY4r*ytQ8ixiPMH5<6d-Ym(j7Rc(f`%i+_i zLnehMsKvuIaPdc4`E(F7uZir8#+RJ`VpvvK~N%YQQ?ADi{sW|C}R^#!YpIsJJkUxFIsR`$H8c0sv3K9GIrmd zmMBRcCWR|Aki7FdC>Yo1NmUx)co0s2bTP~*(Rp@~xe;2HhI4#r@`dkLe~d*DPY934 zP%g2p&h%f>+uJ{G)AHZ3c6_^exwP6cg`M`hMr7y<>fjySZ&fvmSa*f`adp-BGtlC> zJ5jpo@{7c%;X4O2Zug6r-}ol7s2yf^A1$SplIn!R@18XZp`~(WLS(*8Oo$@o3r${Y zVnq~l^3#7v^!oN3$rQEFfsUyD8*qA!XT9-*JNXYrr+!u6cgE!p9s znJiURT*uo|UXBzGVA4ZyxQt0vF_=+1nGZve1+hEXWl%yXKfL#!yC3InHjOF=+@6?h zduyUfb6t4cvwEt?W}dkHU%jhIq_SRxufUp^8r47D{}e8dtQTA($~A@YL1PN9TO8~6 zfz}Rkn2mb|i7kKiGQ^o2YwTx4rn_=z!dnG|J{^CiishAj%F>36P1XYrI7J;p5Q|D! zppM1B1miS7EcBhgrq0A9WR5_@YN;e58|`qYak|(w*Z|eZ9VC|^%j%p%OYCJ z_ZGMi$@y3IPK(zvwrwvNx<-Z}N5PIjxT!Ww@!%Xq21G zwP0oYPEk~&cK&5r-;q%Xs@~nU6xA~1{`TVgD#ZDPT?fY2Bnk6}$&b}iDTOL}d6+B0gEoKrugwDlOEef*Ov3O2xnTk=Xp`uO_sBz^JRw9L~z z7sVg6b$Trqppq1G^@SDMiZbWOtp%p93(q1CpS|Cz6w%HPT}La(9}#u`2u+-tvk?OE z>;yAH&6o`q8AUjozfrdzIMg{e5>(s&Qze^I$*|YF)zNP`sJ3csJKwQr>cbQ12;4N) zfD+COHtX|h8cymNF=oQ0k9=CD)`dJdnby?&T=cpkh;Khan*G6zJmMy?VAFm<%=KXT z;{ef$l1g%EK(!qO%H;md6M7qBw2j?%Bg4mk=+tBxr2D1GyI%@B>+525Ft=;O81Z;} z$e9>jG3Ch*nBZ_D9m!qi=zBFQ(WK_oYJz*|cH+ge75*^shl8V_lflTqQfm4oZN49J zy33oDw|1`D!8uhyDrj;5SMtNKt|j1aK66`GcCOF{!1`ZHzTjGLqg!6&%5Bk219}ulyNr zZVuIw_|*WU@hmX!E(X5=Bd%t93)YRy)G7b4&dQ zEB4?{Y&VIkt*cpS6n_W~1o#1n`)+{VGFIE98TfHuUeZC3zzgHy9w_y3JFQfF>nF?h z&PHw|3RP29H$T!~V3OD?ZZ2fIk%}}DCDYTPZ`!7u+MAHsBztyCvbS=w$tS6AJx@@Ts)UK(p z^d`e&fRJ8DDKM|IvjB>4-$_Q|lt)1s=Eso7`PA9KrF9 z3>UxkW1}b2D$K8Pd91ES$3G1&o%FfBF1~5%`e;mKCwC=J;l0T2wYvR+Ue9K}sNd2C zm;@~8RZ7J~fh=olYizKR%%vhDp`!p?lUZNQeS%_H*TTU|i>UtVIhS2736`>Pf?D*ruq+w|A zKY~R+?$o-~0yty@Mj1ZXoO^*rF3;|CtZk*0I)N9i7eZfIJHswMQJJk}XA#$5 zGUZ!XzL@KNTtZ^6uhX+2h`4f@G(_{aiP&4K8`scMx6&l|xr$HF-pXmrL{nQk5hkP* zi7EexF69t~KofvjfD z`*6lOMwOk$7fSx8cdKNGq%T-5P1Nsoie2lo_N+PM)>jSH&i<1@Tpn#0QkCOm=ca55 zlz5Dss|wop^;`L_woTq&uKSv8xSvfA)eFda9PDih&n)B^!3q`ZgEo`SVYB9Nw!Pr^4ebaY+r%3RXGg{H;Xnd!Mrd)5COWpW(i1%(I^qAXHS(nPXAr&+3w>W3!;Gi+}&agAEM;_t}EEb2| z-5PW;u(OXbiYtBBSLJD6<=n=y{WBZCmt90p*Cp8@HzuH+Q$P7eM&uviH%Yw$N;CTM3U7RG4Don*^GJ;ziO0(Vx*9rkB#cv{3XKcr(Fu3LUHkLOKg`>jX(S#fZOkuLX8N-ZYCtf;oo zywJw7w}R^w@>dmTf?NOc5|M~4T=y?kjFdXj?+!zTqj(FE+*fCkc92YCve z5b|eg<F^3EhqW$&if41cxOX3=0$cj#G>GT zJOVeZT-_gRVdi?o6oU3PN)6d&XYS1rnCFk6_x~dqmH;I+aaHSl0PleARrk5a6BW+tN0F%nE3e^j*VPcLdPVl9h z=z+t>&Q0=-I=XH)Fdx@WMBSM6%a_Z9@&9eu0`VP!0KKYeRlC9o|LqY!a~m-kL%_!E z(!U4GGb_-)$27;4+E@jh#Sqn>H5I*yz{!9;B?*Qbfc6in3Ddy3_XjE~2G>okB_W+u zZ#G}HUhej}q4q+5Xe$^(;cJ}o_sF|52k&8@sQ#{~8Zbp|rU$Q9wqdLq3R#j61Y^g3 zGd-|zA!zh<01Ma@1g7vmpS^J%)}2pj;ltKX*lnJ}TFd1DT^l*>gShQ9?*$pj{%7viLi=!@q(DA)sTy_nYsmQu<5^ zOp7;`#it=7wJMV(=?^DR%reXjtleNe=eL%}mZ5@qi&aZ9gpIWj>?P9TRJx!_!Ts=l z6x_@4uMW!TgSlhkPUj4X!3XiwAvb>^-DaOPdHh(|huMxrkF$A)hoD?rkA}^@$pc}o z3e9vm{(rIJ%L1IBo@qvmiZA>*P;&K`*%O8txiyq^PisRY;ZiVhVL6{@`21|i>nLqmSf$&)98AGFd49Sx&i2&$m^zO^_c;hSy# z(vljjL|S<-oX0aKYh)PCL4T8RuU_cF-htcWdRtCQJfY@4>naAUZWMhpI%VcpA-`|D z$|HOI!rJUJ`f{uG#f)dv-)m;lq1(x9)2=TQ*FT+y2KfOhWW!JscnwdWgZ|To0J!;< zkw^Yx!|DefkFhsFS3*TP8xFRH+K%JqY70+vN&*P7E)|{F=X$*Z(VEYy^%_Q9?;Ey9 ztxqecZ8t+^k@P;}Ur7@H;&vJHK<@r^4p4BFaLUgfY&^S}_x%&vfX!_Qz4a3T9SLZJ zk~{PlSY9Cryb`d!Xh`=ltgtJ$DxRRnDXJ7PN9o`$M%dCI)#Y|lHHpGj3a^SwR-2#-A*Pln1tRA*t?GGBhwKOo{_AatX5SXjA|x64ur?Vr6hzdCeoj*W>cyZ*3MMZr^QE7J|REqwCEW|_HtP%l=`(uotd zh02hlXSW&p&`$|wi>F##$(|@kLby#0*LeS;Qf*K zwchTYym;WhHmOI6|K*rRpc;}t>p@DvG&M|r+dAq{t`dUC|{?`C7VdgN`BXh$`;-LNz2ZQJXJYB%C@%W z;)`=AwE5OUs34r?W(uA3piLzs2bqcU)>7k*W5lR?}0l z9?sX@X|bMFzVgvc*cayNJg^I~=5c$I-dR0{inWeNdwC(>trsqQT)kuKnO%%^svMFQ z-Q#(T>Wjbejp@|Qq#M1}H|f>SI7+E(GP&NWHe0`qMuELR{?R4xtp!U3zolUz|2+POZ1NJMJ#R8;_pOu)f)Lna03NCsbRv(Oa?&&@ z-W<8|^|cIVt$f8!!ODEVLPRgkUlQpRQtUI|w@$B~#WgaR>DjC?)LmJ1_GiteflPy( zm=K3mh0*eeB;0Fb_VXl^R93m*BY$oo5OSKY%ZMFGdt0Of+gu2)OtT*=cw-*=#x0Zq z=^RdT=OT;X#T`>W;=LpMD!=JNHO{ERmRj4O`6ise>%NYR3zhfhQo36V?I^9*Qg7ln ziylVhjT#6#W)S(5prZiGzjhZ#_9=He*Z+B;K+N2g2UZKIc zkDKQB6e%K7kLI-DWUqhpf_A2czWk`g&5&vE8z_)$1&c)^!#(Of$6Zqoh=IFnLgRTy ze(qwf``TB})+yhf&^$ev0Wazd5TavYQl_Wnu_jNpi7NV42=)PC*OeW| zS3Z4n>eiIUl-Cpn0Who7-(Bce%cPpqra7%YapIPbLrrw*2O)PV^&J(?WL=3{`d~i?Kgo06p_^IREHKYF<)VQXMmJWn~4S(978;IO$gn zLU($fPNaO{djlC*gG=d3H8T*KEaFoQ4lJ5@&!`%xaeHB)B#47AaOG|AeSX@P2XUPR zPd%k5;+zsEBorics{Y$os4RP(4Xc|g1jcUc`U-wuW}66*YK|1a+C>n>o5t8D_>ilH zp*u6`Bm;q9(+I3o6LG4E$cj*7su`a#2*v!2v5Km>qG(oQrf6Pcu4qwXp|}e*aMYa@ z{OLFLNF$a7eN|5$Mc`T3My~2eHPfBInne&@#YQ8rmm`SoVxuY8F>VT)3897void&> zoidxUn6jF(nX;R5m~xtOp1M9yuA;+1*=z15m%uGvwC@pgObW@);IllXI_oag%~d+f z9FKP5EwNET6!FtT51U_uUTmGd)REm@&|cDB(O%Qu(Ehf)xxH;`2k%1}+EIlA_El7Ys zRc_Q-aHUR4i?ty$>nv|p_eFhZmL7&reT5o^CcTfI_`4^V${h(83BRv<;jdfiae_n0 z?*_Qq6uD1AKYH%7mKu&kSV3LOQnxjM)=hK&{o3pQeH`|rjtVj}Xcd+KeaP4oFmC(P z%&|UmG>IXpOwJmVBCi7QMg-|71HTK^k8aC z2xCgIlAFJ|;#upRq*r2Orbi>9{w&|4acwxdkWdf(Uke%>*IDw^Pm0k6iLIH40q84} zdgyf86qNIO58Yq?e=|N~-SOT(6hFZT1&9GF3|Y4tcnazT{~S;7o6cz`Rm01qj1gzg zmr7i%3GiQ!+#a79tAA-Y9$q^>X5mivt0SKWR@P62@^L@GmO)`JrWZWmMHp6=1^N}b hEAjvQ3-{zZ1@?K+U8cdq&hb|>dRmt>3)LO&|1Wo>W@-Qc literal 0 HcmV?d00001 From 51fb13d57b925a44e0ccab627925003f78009680 Mon Sep 17 00:00:00 2001 From: javamaker Date: Fri, 3 May 2024 17:26:21 +0800 Subject: [PATCH 6/7] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E8=B5=84=E6=96=99?= =?UTF-8?q?=E4=BF=A1=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 3491917..dbca819 100644 --- a/README.md +++ b/README.md @@ -10,17 +10,17 @@ 👉 Java学习资源汇总（个人总结） -- Java基础到Java实战全套学习视频教程，包括多个企业级实战项目; +- **Java基础到Java实战全套学习视频教程，包括多个企业级实战项目** -- 面试算法资料，这是总结的算法资料，学完基本可以应付80%大厂; +- **面试算法资料，这是总结的算法资料，学完基本可以应付80%大厂** -- 大厂面试资料，一年时间总结，覆盖Java所有技术点; +- **大厂面试资料，一年时间总结，覆盖Java所有技术点** -- 面试思维导图，手打总结; +- **面试思维导图，手打总结** -👉 Java各种电子书：各种技术相关的电子书； +👉 **Java各种电子书：各种技术相关的电子书** -👉 Java面试思维导图（手打），我靠这些导图拿到了一线互联网公司的offer，关注公众号，回复：`思维导图`； +👉 **Java面试思维导图（手打）**，我靠这些导图拿到了一线互联网公司的offer，关注公众号，回复：`思维导图`； **划重点**：获取上面的资源，请关注我的公众号 `程序员的技术圈子`，**微信扫描下面二维码**，回复：`Java资料`，获取思维导图，绿色通道关注福利，等你拿。 From cb1e426145d2df3682eeec922d2052732403e3ab Mon Sep 17 00:00:00 2001 From: javamaker Date: Fri, 3 May 2024 17:41:23 +0800 Subject: [PATCH 7/7] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E8=B5=84=E6=96=99?= =?UTF-8?q?=E4=BF=A1=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index dbca819..1c7180e 100644 --- a/README.md +++ b/README.md @@ -151,18 +151,18 @@ #### 阻塞容器 -- ConcurrentHashMap源码分析及真实大厂面试题精讲 +- [ConcurrentHashMap源码分析及真实大厂面试题精讲](https://blog.csdn.net/sihai12345/article/details/138420403) - ArrayBlockingQueue源码分析及真实大厂面试题精讲 - LinkedBlockingQueue源码分析及真实大厂面试题精讲 - PriorityBlockingQueue源码分析及真实大厂面试题精讲 ### 并发 -- Synchronized关键字精讲及真实大厂面试题解析 -- Volitale关键字精讲及真实大厂面试题解析 +- [Synchronized关键字精讲及真实大厂面试题解析](https://blog.csdn.net/sihai12345/article/details/138420474) +- [Volitale关键字精讲及真实大厂面试题解析](https://blog.csdn.net/sihai12345/article/details/138420521) - 关于LRU的实现 -- ThreadLocal面试中会怎么提问呢？ -- 线程池的面试题，这篇文章帮你搞定它！ +- [ThreadLocal面试中会怎么提问呢？](https://blog.csdn.net/sihai12345/article/details/138420558) +- [线程池的面试题，这篇文章帮你搞定它！](https://blog.csdn.net/sihai12345/article/details/138420591) ### JVM

2ht@7L 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