馬斯克承認低油價不利電動車銷售,但稱特斯拉較不受影響

2{icon} {views}

油價直直落,美國人大買耗油車,這股風潮豈不是對電動車相當不利?特斯拉(Tesla)執行長艾隆‧馬斯克(Elon Musk)於 2016 年 1 月底受邀前往香港 StartmeupHK 新創論壇(StartmeupHK Venture Forum)擔任演講來賓,在香港受 CNN 訪問時,承認低油價對整體電動車市場不利,但認為特斯拉將比其他電動車對手更不受影響。

馬斯克承認低油價對電動車的不利影響,表示這符合經濟常識。事實上,低油價已經使得 2015 年美國車市燒油較兇的貨卡以及休旅車大行其道,就更大的市場方向來說,油價的經濟考量,也顯然會對消費者在傳統燃油車、油電混合車,以及全電動車之間的選擇發生影響力。   不過馬斯克認為,特斯拉受到的影響將較其他電動車對手小,因為特斯拉將本身定位於高檔市場,因此其消費者購車時的經濟考量程度較輕,相對的,馬斯克認為以低價搶市的電動車對手,面對低油價讓燃油車更為經濟的情況,將會大受打擊,他表示,有些電動車和燃油車車款除了動力來源並沒有基本差異,如此一來,消費者只會比較經濟面,這樣的電動車對手將會在低油價下受到重大影響,但是馬斯克認為就算低油價讓燃油車更為經濟,特斯拉的 Model 3 仍然會表現良好。Model 3 是特斯拉較為大眾取向的車款,車價 3.4 萬美元,相當於約 114 萬元新台幣。   馬斯克也歡迎其他車廠共襄盛舉,一同推出更多電動車,可把餅做大,如通用汽車(GM)的雪佛蘭(Chevrolet)Bolt,馬斯克表示,若通用汽車或其他車廠開發出讓消費者滿意的電動車,對世界是好事,他會歡迎它們。   馬斯克也談及中國市場,表示中國電動車市場雖然只是剛開始起步,但正朝向正確的方向邁進,他表示有些中國公司,指巴菲特投資的比亞迪,正朝著製造出性能良好電動車的方向前進,進展快速。不過,特斯拉本身在中國市場表現並不理想,要如何在中國建立生產線,特斯拉還在嘗試中,而身為進口車,特斯拉要蒙受高額進口稅,且無法得到中國政府對電動車的補貼,因此受到相當大的阻礙,一旦能在中國本地生產,將對生意有相當大助益。   馬斯克認為中國政府政策將不可避免的往電動車傾斜,以減輕空氣污染與碳排放,中國政府也了解電動車對未來相當重要,想讓城市擁有潔淨空氣,就必須發展電動車。馬斯克認為 Model 3 終有一天會在中國生產,不過可能要 3 年才能辦得到這點。

(首圖來源:)    (本文授權轉載自《》─〈〉)

本站聲明:網站內容來源於EnergyTrend https://www.energytrend.com.tw/ev/,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?

使用JaCoCo Maven插件創建代碼覆蓋率報告

1{icon} {views}

這篇博客文章描述了我們如何使用JaCoCo Maven插件為單元和集成測試創建代碼覆蓋率報告。

我們的構建要求如下:

運行測試時,我們的構建必須為單元測試和集成測試創建代碼覆蓋率報告。
代碼覆蓋率報告必須在單獨的目錄中創建。換句話說,必須將用於單元測試的代碼覆蓋率報告創建到與用於集成測試的代碼覆蓋率報告不同的目錄中。
讓我們開始吧。

配置JaCoCo Maven插件

我們使用JaCoCo Maven插件有兩個目的:

  • 它使我們可以訪問JaCoCo運行時代理,該代理記錄了執行覆蓋率數據。
  • 它根據JaCo​​Co運行時代理記錄的執行數據創建代碼覆蓋率報告。
  • 我們可以按照以下步驟配置JaCoCo Maven插件:

將JaCoCo Maven插件添加到我們的POM文件的插件部分。

  • 為單元測試配置代碼覆蓋率報告。
  • 配置代碼覆蓋率報告以進行集成測試。
    下面將更詳細地描述這些步驟。

將JaCoCo Maven插件添加到POM文件

通過將以下插件聲明添加到其“ 插件”部分,我們可以將JaCoCo Maven插件添加到我們的POM文件中:

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.6.3.201306030806</version>
</plugin>

配置單元測試的代碼覆蓋率報告

我們可以通過將兩個執行添加到插件聲明中來為單元測試配置代碼覆蓋率報告。這些執行方式如下所述:

  • 第一次執行將創建一個指向JaCoCo運行時代理的屬性。確保執行數據已寫入文件target / coverage-reports / jacoco-ut.exec。將該屬性的名稱設置為surefireArgLine。運行單元測試時,此屬性的值作為VM參數傳遞。
  • 運行單元測試后,第二次執行將為單元測試創建代碼覆蓋率報告。確保從文件target / coverage-reports / jacoco-ut.exec中讀取執行數據,並將代碼覆蓋率報告寫入目錄target / site / jacoco-ut中。

我們的插件配置的相關部分如下所示:

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.6.3.201306030806</version>
    <executions>
        <!--
           Prepares the property pointing to the JaCoCo runtime agent which
           is passed as VM argument when Maven the Surefire plugin is executed.
       -->
        <execution>
            <id>pre-unit-test</id>
            <goals>
                <goal>prepare-agent</goal>
            </goals>
            <configuration>
                <!-- Sets the path to the file which contains the execution data. -->
                <destFile>${project.build.directory}/coverage-reports/jacoco-ut.exec</destFile>
                <!--
                   Sets the name of the property containing the settings
                   for JaCoCo runtime agent.
               -->
                <propertyName>surefireArgLine</propertyName>
            </configuration>
        </execution>
        <!--
           Ensures that the code coverage report for unit tests is created after
           unit tests have been run.
       -->
        <execution>
            <id>post-unit-test</id>
            <phase>test</phase>
            <goals>
                <goal>report</goal>
            </goals>
            <configuration>
                <!-- Sets the path to the file which contains the execution data. -->
                <dataFile>${project.build.directory}/coverage-reports/jacoco-ut.exec</dataFile>
                <!-- Sets the output directory for the code coverage report. -->
                <outputDirectory>${project.reporting.outputDirectory}/jacoco-ut</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

讓我們找出如何為集成測試配置代碼覆蓋率報告。

配置集成測試的代碼覆蓋率報告

我們可以通過在插件聲明中添加兩個執行來為集成測試配置代碼覆蓋率報告。這些執行方式如下所述:

  • 第一次執行將創建一個指向JaCoCo運行時代理的屬性。確保將執行數據寫入文件target / coverage-reports / jacoco-it.exec。將該屬性的名稱設置為failsafeArgLine。運行我們的集成測試時,此屬性的值作為VM參數傳遞。
  • 創建一個執行,該執行在集成測試運行後為集成測試創建代碼覆蓋率報告。確保從文件target / coverage-reports / jacoco-it.exec中讀取執行數據,並將代碼覆蓋率報告寫入目錄target / site / jacoco-it。

我們的插件配置的相關部分如下所示:

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.6.3.201306030806</version>
    <executions>
        <!-- The Executions required by unit tests are omitted. -->
        <!--
           Prepares the property pointing to the JaCoCo runtime agent which
           is passed as VM argument when Maven the Failsafe plugin is executed.
       -->
        <execution>
            <id>pre-integration-test</id>
            <phase>pre-integration-test</phase>
            <goals>
                <goal>prepare-agent</goal>
            </goals>
            <configuration>
                <!-- Sets the path to the file which contains the execution data. -->
                <destFile>${project.build.directory}/coverage-reports/jacoco-it.exec</destFile>
                <!--
                   Sets the name of the property containing the settings
                   for JaCoCo runtime agent.
               -->
                <propertyName>failsafeArgLine</propertyName>
            </configuration>
        </execution>
        <!--
           Ensures that the code coverage report for integration tests after
           integration tests have been run.
       -->
        <execution>
            <id>post-integration-test</id>
            <phase>post-integration-test</phase>
            <goals>
                <goal>report</goal>
            </goals>
            <configuration>
                <!-- Sets the path to the file which contains the execution data. -->
                <dataFile>${project.build.directory}/coverage-reports/jacoco-it.exec</dataFile>
                <!-- Sets the output directory for the code coverage report. -->
                <outputDirectory>${project.reporting.outputDirectory}/jacoco-it</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

現在,我們已經配置了JaCoCo Maven插件。下一步是配置Maven Surefire插件。讓我們找出如何做到這一點。

配置Maven Surefire插件

我們使用Maven Surefire插件運行示例應用程序的單元測試。因為我們要為單元測試創​​建代碼覆蓋率報告,所以我們必須確保在運行單元測試時JaCoCo代理正在運行。我們可以通過添加的價值保證本surefireArgLine財產作為價值argLine配置參數。

Maven Surefire插件的配置如下所示(突出显示了所需的更改):

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.15</version>
    <configuration>
        <!-- Sets the VM argument line used when unit tests are run. -->
        <argLine>${surefireArgLine}</argLine>
        <!-- Skips unit tests if the value of skip.unit.tests property is true -->
        <skipTests>${skip.unit.tests}</skipTests>
        <!-- Excludes integration tests when unit tests are run. -->
        <excludes>
            <exclude>**/IT*.java</exclude>
        </excludes>
    </configuration>
</plugin>

我們快完成了。剩下要做的就是配置Maven Failsafe插件。讓我們找出如何做到這一點。

配置Maven故障安全插件

我們的示例應用程序的集成測試由Maven Failsafe插件運行。因為我們要為集成測試創建代碼覆蓋率報告,所以我們必須確保在運行集成測試時JaCoCo代理正在運行。我們可以通過將failsafeArgLine屬性的值添加為argLine配置參數的值來實現。

Maven Failsafe插件的配置如下所示(突出显示了所需的更改):

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>2.15</version>
    <executions>
        <!--
            Ensures that both integration-test and verify goals of the Failsafe Maven
            plugin are executed.
        -->
        <execution>
            <id>integration-tests</id>
            <goals>
                <goal>integration-test</goal>
                <goal>verify</goal>
            </goals>
            <configuration>
                <!-- Sets the VM argument line used when integration tests are run. -->
                <argLine>${failsafeArgLine}</argLine>
                <!--
                    Skips integration tests if the value of skip.integration.tests property
                    is true
                -->
                <skipTests>${skip.integration.tests}</skipTests>
            </configuration>
        </execution>
    </executions>
</plugin>

創建代碼覆蓋率報告

現在,我們已成功完成所需的配置。讓我們看看如何為單元測試和集成測試創建代碼覆蓋率報告。

此博客文章的示例應用程序具有三個構建配置文件,下面對此進行了描述:

  • 在開發配置文件開發過程中使用,這是我們構建的默認配置文件。當此配置文件處於活動狀態時,僅運行單元測試。
  • 在集成測試配置文件用於運行集成測試。
  • 在所有的測試配置文件用於為運行單元測試和集成測試。
    我們可以通過在命令提示符處運行以下命令來創建不同的代碼覆蓋率報告:

  • 命令mvn clean test運行單元測試,併為目錄target / site / jacoco-ut創建單元測試的代碼覆蓋率報告。
  • 命令mvn clean verify -P integration-test運行集成測試,併為目錄target / site / jacoco-it創建用於集成測試的代碼覆蓋率報告。
  • 命令mvn clean verify -P all-tests運行單元測試和集成測試,併為單元測試和集成測試創建代碼覆蓋率報告。

技術類文章精選

非技術文章精選

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?

Kubernetes概述

2{icon} {views}

1. Kubernetes是什麼

Kubernetes是一個可移植的、可擴展的、用於管理容器化工作負載和服務的開源平台,它簡化(促進)了聲明式配置和自動化。它有一個龐大的、快速增長的生態系統。Kubernetes的服務、支持和工具隨處可見。

Kubernetes一詞源於希臘語,意為舵手或飛行員。2014年,谷歌開放了Kubernetes項目的源代碼。Kubernetes基於谷歌在大規模運行生產工作負載方面的15年經驗,以及來自社區的最佳想法和實踐。

使用 Kubernetes, 我們可以快速高效地響應客戶需求:

  • 快速、可預測地部署你的應用程序
  • 擁有即時擴展應用程序的能力
  • 不影響現有業務的情況下,無縫地發布新功能
  • 優化硬件資源,降低成本

Kubernetes的目標是構建一個軟件和工具的生態系統,以減輕你在公共雲或私有雲運行應用程序的負擔。

1.1. 時光倒流

讓我們把時間回溯到從前,看看為什麼Kubernetes是如此有用。

傳統部署時代在早期,組織在物理服務器上運行應用程序。無法為物理服務器中的應用程序定義資源邊界,這導致了資源分配問題。例如,如果一個物理服務器上運行多個應用程序,那麼在某些情況下,一個應用程序將佔用大部分資源,從而導致其他應用程序性能下降。對此的解決方案是在不同的物理服務器上運行每個應用程序。但是,由於資源沒有得到充分利用,而且維護許多物理服務器的成本很高,所以無法進行擴展。

虛擬化部署時代作為一種解決方案,引入了虛擬化。它允許你在單個物理服務器的CPU上運行多個虛擬機(vm)。虛擬化允許在vm之間隔離應用程序,並提供一定程度的安全性,因為一個應用程序的信息不能被另一個應用程序自由訪問。

虛擬化可以更好地利用物理服務器中的資源,並提供更好的可伸縮性,因為可以方便地添加或更新應用程序,從而降低硬件成本,等等。通過虛擬化,你可以將一組物理資源表示為一次性虛擬機集群。

每個VM是一個完整的機器,運行所有組件,包括它自己的操作系統,運行在虛擬硬件之上。

容器部署時代容器類似於vm,但是它們具有寬鬆的隔離屬性,以便在應用程序之間共享操作系統(OS)。因此,容器被認為是輕量級的。與VM類似,容器有自己的文件系統、CPU、內存、進程空間等等。由於它們與底層基礎設施解耦,因此可以跨雲和OS發行版移植。

容器已經變得很流行,因為它們提供了額外的好處,比如:

  • 敏捷應用程序創建和部署:與使用VM鏡像相比,增加了容器鏡像創建的方便性和效率
  • 持續開發、集成和部署:提供可靠且頻繁的容器鏡像構建和部署,具有快速且輕鬆的回滾
  • 開發和運維關注點分離:在構建/發布時而不是部署時創建應用程序容器鏡像,從而將應用程序與基礎設施分離
  • 可觀察性:不僅能显示操作系統級的信息和指標,還能显示應用程序的健康狀況和其他信號
  • 跨開發、測試和生產的環境一致性:在筆記本電腦上運行與在雲上運行完全相同
  • 雲和操作系統發布的可移植性:運行在Ubuntu, RHEL, CoreOS, on-prem,谷歌Kubernetes引擎,和其他任何地方
  • 以應用程序為中心的管理:將抽象級別從在虛擬硬件上運行操作系統提高到使用邏輯資源在操作系統上運行應用程序
  • 鬆散耦合、分佈式、彈性、解放的微服務:應用程序被分解成更小的獨立部分,可以動態地部署和管理——而不是運行在一台大型單用途機器上的單片堆棧
  • 資源隔離:可預測的應用程序性能
  • 資源利用:效率高,密度大 

1.2. 為什麼需要Kubernetes?它能做什麼?

容器是捆綁和運行應用程序的好方法。在生產環境中,你需要管理運行應用程序的容器,並確保沒有停機時間。例如,如果一個容器發生故障,則需要啟動另一個容器。如果這個行為由一個系統來處理不是更容易嗎?

Kubernetes為你提供了一個能夠彈性地運行分佈式系統的框架。它負責處理應用程序的擴展和故障轉移,提供部署模式,等等。

Kubernetes為你提供:

服務發現和負載平衡

  Kubernetes可以使用DNS名稱或自己的IP地址公開容器。如果到容器的通信量很高,Kubernetes能夠實現負載平衡並分配網絡通信量,從而使部署保持穩定

存儲編排

  Kubernetes允許你自動掛載自己選擇的存儲系統,比如本地存儲、公有雲提供商等等

自動滾動更新和回滾

  可以使用Kubernetes描述所部署容器的期望狀態,並且可以以受控的速率將實際狀態更改為期望狀態

自動包裝

  你只需為Kubernetes提供一組節點,它便可以使用這些節點來運行容器化的任務。告訴Kubernetes每個容器需要多少CPU和內存(RAM)。Kubernetes可以在你的節點上放置容器,以充分利用你的資源。 

自動重啟 

  Kubernetes會重新啟動失敗的容器,替換容器,殺死不響應用戶定義的健康檢查的容器,並且在它們準備好服務之前不會將他們暴露給客戶端。

秘密和配置管理

  Kubernetes允許你存儲和管理敏感信息,比如密碼、OAuth令牌和ssh密鑰。你可以部署和更新秘密和應用程序配置,而無需重新構建容器映像,也無需在堆棧配置中公開秘密。 

1.3. Kubernetes不是什麼

Kubernetes不是一個傳統的、包羅萬象的PaaS(平台即服務)系統。由於Kubernetes是在容器級別而不是在硬件級別操作的,所以它提供了一些PaaS產品常見的通用特性,例如部署、擴展、負載平衡、日誌記錄和監視。但是,Kubernetes不是單片的,這些默認的解決方案是可選的和可插拔的。Kubernetes為構建開發人員平台提供了構建塊,但是在重要的地方保留了用戶的選擇和靈活性。

  • 不限制所支持的應用程序類型。Kubernetes的目標是支持非常多樣化的工作負載,包括無狀態、有狀態和數據處理工作負載。如果一個應用程序可以在容器中運行,那麼它應該可以在Kubernetes上運行。
  • 不部署源代碼,也不構建應用程序。持續集成、交付和部署(CI/CD)工作流由組織文化和偏好以及技術需求決定。
  • 不提供應用級服務,如中間件(例如消息總線)、數據處理框架(例如Spark)、數據庫(例如mysql)、緩存,也不提供集群存儲系統(例如Ceph)作為內置服務。這些組件可以運行在Kubernetes上,並且/或者可以由運行在Kubernetes上的應用程序通過可移植的機制(如Open Service Broker)訪問。
  • Kubernetes 允許用戶選擇其他的日誌記錄,監控和告警系統 
  • 不提供也不強制要求配置語言/系統(例如,jsonnet)。它提供了一個聲明性API,可以被任意形式的聲明性規範作為目標。
  • 不提供也不採用任何全面的機器配置、維護、管理或自修復系統。
  • 此外,Kubernetes不僅僅是一個編排系統。事實上,它消除了對編排的需要。編排的技術定義是執行一個已定義的工作流:首先執行a,然後執行B,然後執行c。相反,Kubernetes包括一套獨立、可組合的控制過程,通過聲明式語法使其連續地朝着期望狀態驅動當前狀態。你怎麼從A點到c點都不重要,只要告訴到C的狀態即可。 

2. Kubernetes組件

當你部署Kubernetes的時候,你會得到一個集群。

一個集群是一組機器,稱為節點(nodes),它們運行由Kubernetes管理的容器化應用程序。

一個集群至少有一個工作節點(worker node)和一個主節點(master node)。

工作節點承載應用程序的組件。主節點管理集群中的工作節點和pods。多個主節點用於提供具有故障轉移和高可用性的集群。

下面是Kubernetes集群的關係圖: 

2.1. Master組件

Master組件提供集群的控制面板。Master組件對集群做出全局決策(例如,調度),Master組件檢測並響應集群事件(例如,當部署的replicas字段不滿足時啟動一個新的pod)

Master組件可以在集群中的任何機器上運行。但是,為了簡單起見,設置腳本通常在同一台機器上啟動所有Master組件,並且不在這台機器上運行用戶容器。

kube-apiserver 

  API服務器是一個Kubernetes面板控制組件,用於公開Kubernetes API。它是Kubernetes控制面板的前端。

  Kubernetes API服務器的主要實現是kube-apiserver。kube-apiserver被設計成水平伸縮——也就是說,它通過部署更多實例來伸縮。你可以運行kube-apiserver的多個實例,並在這些實例之間平衡流量。

etcd 

  一致性和高可用的鍵值存儲用作Kubernetes的所有集群數據備份存儲。

  如果你的Kubernetes集群使用etcd作為其備份存儲,請確保對這些數據有備份計劃。

kube-scheduler

  監視沒有分配節點的新創建的pod,併為它們選擇要運行的節點。 

kube-controller-manager

  運行控制器的組件,從邏輯上講,每個控制器都是一個單獨的進程,但是為了降低複雜性,它們都被編譯成一個單一的二進制文件,並在一個進程中運行。

這些控制器包括:

  • Node Controller:節點控制器負責發現和響應節點故障
  • Replication Controller:副本控制器負責為系統中的每個副本控制器對象維護正確的pod數量
  • Endpoints Controller:端點控制器填充端點對象(即,連接服務和pod)
  • Service Account & Token Controllers:為新的名稱空間創建默認帳戶和API訪問令牌 

cloud-controller-manager 

  雲控制器-管理器,運行與底層雲提供商交互的控制器

2.2. Node組件

Node組件在每個節點上運行,維護運行的pods並提供Kubernetes運行時環境。 

kubelet

  kubelet是一個代理,它運行在集群中的每個節點上,它確保容器在一個pod中運行。kubelet只管理由Kubernetes創建的容器。 

kube-proxy

  kube-proxy是運行在集群中每個節點上的網絡代理,是實現Kubernetes服務概念的一部分。

  kube-proxy維護節點上的網絡規則。這些網絡規則允許從集群內外的網絡會話與pod進行網絡通信。

  如果有可用的操作系統包過濾層,kube-proxy將使用它。否則,kube-proxy將轉發流量本身。

Container Runtime

  容器運行時是負責運行容器的軟件。

  Kubernetes支持多個容器運行時:DockercontainerdcriorktletKubernetes CRI(容器運行時接口)的任何實現。 

2.3. Addons(插件)

DNS

  雖然其他插件不是嚴格要求的,但所有Kubernetes集群都應該有集群DNS,因為許多示例都依賴於它。

Web UI (Dashboard)

  Dashboard是一個通用的、基於web的Kubernetes集群用戶界面。它允許用戶管理和排除集群中運行的應用程序和集群本身的故障。

Container Resource Monitoring

  容器資源監控記錄中央數據庫中容器的一般時間序列指標,並提供用於瀏覽該數據的UI。

Cluster-level Logging

  集群級別的日誌記錄機制負責將容器日誌保存到具有搜索/瀏覽界面的中央日誌存儲中。

3. 回顧&小結

Kubernetes:

  • 可移植: 無論公有雲、私有雲、混合雲還是多雲架構都全面支持
  • 可擴展: 它是模塊化、可插拔、可掛載、可組合的,支持各種形式的擴展
  • 自修復: 它可以自保持應用狀態、可自重啟、自複製、自縮放的,通過聲明式語法提供了強大的自修復能力

Kubernetes建立在Google公司15年的運維經驗基礎之上,Google所有的應用都運行在容器上 

 

 

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?

2016 第二屆 亞太新能源汽車國際峰會

3{icon} {views}

隨著全球能源危機的加重及汽車排放引起的環境問題日益得到世界各國的重視,智慧化,網聯化和電動化已成為未來全球汽車行業發展的必然趨勢。汽車行業是能源、資源消耗較大的產業,同時汽車排放也是環境污染的重要原因。我國已經步入汽車生產和消費大國,節能、環保、低碳是我國汽車產業面臨的長期任務。

在此背景下,2016第二屆亞太新能源汽車國際峰會以 “助力智慧網聯電動交通”為主題,旨在為全球新能源汽車參與者打造一個瞭解中國新能源汽車發展現狀,商業模式和技術發展趨勢的前瞻性產業交流平臺。

會議日程:

會議首日(2016.06.02; 星期四)
上午:新能源汽車產業政策及發展趨勢
下午:新能源汽車動力電池及動力總成技術

會議次日(2016.06.03; 星期五)
上午:整車集成,汽車電子及充電解決方案
下午:先進智慧網聯及輕量化技術助力電動交通戰略

更多關於2016ANEVS的資訊,請登錄會議官方網站:

組委會聯繫方式:
連絡人:Fiona Hu           
電  話:021-58560121
郵  箱:

本站聲明:網站內容來源於EnergyTrend https://www.energytrend.com.tw/ev/,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?

Python 命令行之旅:深入 click 之選項篇

1{icon} {views}

作者:HelloGitHub-Prodesire

HelloGitHub 的《講解開源項目》系列,項目地址:https://github.com/HelloGitHub-Team/Article

一、前言

在上一篇文章中,我們介紹了 click 中的“參數”,本文將繼續深入了解 click,着重講解它的“選項”。

本系列文章默認使用 Python 3 作為解釋器進行講解。
若你仍在使用 Python 2,請注意兩者之間語法和庫的使用差異哦~

二、選項

通過 click.option 可以給命令增加選項,並通過配置函數的參數來配置不同功能的選項。

2.1 給選項命名

click.option 中的命令規則可參考。它接受的前兩個參數為長、短選項(順序隨意),其中:

  • 長選項以 “–” 開頭,比如 “–string-to-echo”
  • 短選項以 “-” 開頭,比如 “-s”

第三個參數為選項參數的名稱,如果不指定,將會使用長選項的下劃線形式名稱:

@click.command()
@click.option('-s', '--string-to-echo')
def echo(string_to_echo):
    click.echo(string_to_echo)

显示指定為 string

@click.command()
@click.option('-s', '--string-to-echo', 'string')
def echo(string):
    click.echo(string)

2.2 基本值選項

值選項是非常常用的選項,它接受一個值。如果在命令行中提供了值選項,則需要提供對應的值;反之則使用默認值。若沒在 click.option 中指定默認值,則默認值為 None,且該選項的類型為 ;反之,則選項類型為默認值的類型。

比如,提供默認值為 1,則選項類型為 :

@click.command()
@click.option('--n', default=1)
def dots(n):
    click.echo('.' * n)

如果要求選項為必填,則可指定 click.optionrequired=True

@click.command()
@click.option('--n', required=True, type=int)
def dots(n):
    click.echo('.' * n)

如果選項名稱和 Python 中的關鍵字衝突,則可以顯式的指定選項名稱。比如將 --from 的名稱設置為 from_

@click.command()
@click.option('--from', '-f', 'from_')
@click.option('--to', '-t')
def reserved_param_name(from_, to):
    click.echo(f'from {from_} to {to}')

如果要在幫助中顯式默認值,則可指定 click.optionshow_default=True

@click.command()
@click.option('--n', default=1, show_default=True)
def dots(n):
    click.echo('.' * n)

在命令行中調用則有:

$ dots --help
Usage: dots [OPTIONS]

Options:
  --n INTEGER  [default: 1]
  --help       Show this message and exit.

2.3 多值選項

有時,我們會希望命令行中一個選項能接收多個值,通過指定 click.option 中的 nargs 參數(必須是大於等於 0)。這樣,接收的多值選項就會變成一個元組。

比如,在下面的示例中,當通過 --pos 指定多個值時,pos 變量就是一個元組,裏面的每個元素是一個 float

@click.command()
@click.option('--pos', nargs=2, type=float)
def findme(pos):
    click.echo(pos)

在命令行中調用則有:

$ findme --pos 2.0 3.0
(1.0, 2.0)

有時,通過同一選項指定的多個值得類型可能不同,這個時候可以指定 click.option 中的 type=(類型1, 類型2, ...) 來實現。而由於元組的長度同時表示了值的數量,所以就無須指定 nargs 參數。

@click.command()
@click.option('--item', type=(str, int))
def putitem(item):
    click.echo('name=%s id=%d' % item)

在命令行中調用則有:

$ putitem --item peter 1338
name=peter id=1338

2.4 多選項

不同於多值選項是通過一個選項指定多個值,多選項則是使用多個相同選項分別指定值,通過 click.option 中的 multiple=True 來實現。

當我們定義如下多選項:

@click.command()
@click.option('--message', '-m', multiple=True)
def commit(message):
    click.echo('\n'.join(message))

便可以指定任意數量個選項來指定值,獲取到的 message 是一個元組:

$ commit -m foo -m bar --message baz
foo
bar
baz

2.5 計值選項

有時我們可能需要獲得選項的數量,那麼可以指定 click.option 中的 count=True 來實現。

最常見的使用場景就是指定多個 --verbose-v 選項來表示輸出內容的詳細程度。

@click.command()
@click.option('-v', '--verbose', count=True)
def log(verbose):
    click.echo(f'Verbosity: {verbose}')

在命令行中調用則有:

$ log -vvv
Verbosity: 3

通過上面的例子,verbose 就是数字,表示 -v 選項的數量,由此可以進一步使用該值來控制日誌的詳細程度。

2.6 布爾選項

布爾選項用來表示真或假,它有多種實現方式:

  • 通過 click.optionis_flag=True 參數來實現:
import sys

@click.command()
@click.option('--shout', is_flag=True)
def info(shout):
    rv = sys.platform
    if shout:
        rv = rv.upper() + '!!!!111'
    click.echo(rv)

在命令行中調用則有:

$ info --shout
LINUX!!!!111
  • 通過在 click.option 的選項定義中使用 / 分隔表示真假兩個選項來實現:
import sys

@click.command()
@click.option('--shout/--no-shout', default=False)
def info(shout):
    rv = sys.platform
    if shout:
        rv = rv.upper() + '!!!!111'
    click.echo(rv)

在命令行中調用則有:

$ info --shout
LINUX!!!!111
$ info --no-shout
linux

在 Windows 中,一個選項可以以 / 開頭,這樣就會真假選項的分隔符衝突了,這個時候可以使用 ; 進行分隔:

@click.command()
@click.option('/debug;/no-debug')
def log(debug):
    click.echo(f'debug={debug}')

if __name__ == '__main__':
    log()

在 cmd 中調用則有:

> log /debug
debug=True

2.7 特性切換選項

所謂特性切換就是切換同一個操作對象的不同特性,比如指定 --upper 就讓輸出大寫,指定 --lower 就讓輸出小寫。這麼來看,布爾值其實是特性切換的一個特例。

要實現特性切換選項,需要讓多個選項都有相同的參數名稱,並且定義它們的標記值 flag_value

import sys

@click.command()
@click.option('--upper', 'transformation', flag_value='upper',
              default=True)
@click.option('--lower', 'transformation', flag_value='lower')
def info(transformation):
    click.echo(getattr(sys.platform, transformation)())

在命令行中調用則有:

$ info --upper
LINUX
$ info --lower
linux
$ info
LINUX

在上面的示例中,--upper--lower 都有相同的參數值 transformation

  • 當指定 --upper 時,transformation 就是 --upper 選項的標記值 upper
  • 當指定 --lower 時,transformation 就是 --lower 選項的標記值 lower

進而就可以做進一步的業務邏輯處理。

2.8 選擇項選項

選擇項選項 和 上篇文章中介紹的 選擇項參數 類似,只不過是限定選項內容,依舊是通過 type=click.Choice 實現。此外,case_sensitive=False 還可以忽略選項內容的大小寫。

@click.command()
@click.option('--hash-type',
              type=click.Choice(['MD5', 'SHA1'], case_sensitive=False))
def digest(hash_type):
    click.echo(hash_type)

在命令行中調用則有:

$ digest --hash-type=MD5
MD5

$ digest --hash-type=md5
MD5

$ digest --hash-type=foo
Usage: digest [OPTIONS]
Try "digest --help" for help.

Error: Invalid value for "--hash-type": invalid choice: foo. (choose from MD5, SHA1)

$ digest --help
Usage: digest [OPTIONS]

Options:
  --hash-type [MD5|SHA1]
  --help                  Show this message and exit.

2.9 提示選項

顧名思義,當提供了選項卻沒有提供對應的值時,會提示用戶輸入值。這種交互式的方式會讓命令行變得更加友好。通過指定 click.option 中的 prompt 可以實現。

  • prompt=True 時,提示內容為選項的參數名稱
@click.command()
@click.option('--name', prompt=True)
def hello(name):
    click.echo(f'Hello {name}!')

在命令行調用則有:

$ hello --name=John
Hello John!
$ hello
Name: John
Hello John!
  • prompt='Your name please' 時,提示內容為指定內容
@click.command()
@click.option('--name', prompt='Your name please')
def hello(name):
    click.echo(f'Hello {name}!')

在命令行中調用則有:

$ hello
Your name please: John
Hello John!

基於提示選項,我們還可以指定 hide_input=True 來隱藏輸入,confirmation_prompt=True 來讓用戶進行二次輸入,這非常適合輸入密碼的場景。

@click.command()
@click.option('--password', prompt=True, hide_input=True,
              confirmation_prompt=True)
def encrypt(password):
    click.echo(f'Encrypting password to {password.encode("rot13")}')

當然,也可以直接使用 click.password_option

@click.command()
@click.password_option()
def encrypt(password):
    click.echo(f'Encrypting password to {password.encode("rot13")}')

我們還可以給提示選項設置默認值,通過 default 參數進行設置,如果被設置為函數,則可以實現動態默認值。

@click.command()
@click.option('--username', prompt=True,
              default=lambda: os.environ.get('USER', ''))
def hello(username):
    print("Hello,", username)

詳情請閱讀 。

2.10 範圍選項

如果希望選項的值在某個範圍內,就可以使用範圍選項,通過指定 type=click.IntRange 來實現。它有兩種模式:

  • 默認模式(非強制模式),如果值不在區間範圍內將會引發一個錯誤。如 type=click.IntRange(0, 10) 表示範圍是 [0, 10],超過該範圍報錯
  • 強制模式,如果值不在區間範圍內,將會強制選取一個區間臨近值。如 click.IntRange(0, None, clamp=True) 表示範圍是 [0, +∞),小於 0 則取 0,大於 20 則取 20。其中 None 表示沒有限制
@click.command()
@click.option('--count', type=click.IntRange(0, None, clamp=True))
@click.option('--digit', type=click.IntRange(0, 10))
def repeat(count, digit):
    click.echo(str(digit) * count)

if __name__ == '__main__':
    repeat()

在命令行中調用則有:

$ repeat --count=1000 --digit=5
55555555555555555555
$ repeat --count=1000 --digit=12
Usage: repeat [OPTIONS]

Error: Invalid value for "--digit": 12 is not in the valid range of 0 to 10.

2.11 回調和優先

回調
通過 click.option 中的 callback 可以指定選項的回調,它會在該選項被解析后調用。回調函數的簽名如下:

def callback(ctx, param, value):
    pass

其中:

  • ctx 是命令的上下文
  • param 為選項變量
  • value 為選項的值

使用回調函數可以完成額外的參數校驗邏輯。比如,通過 –rolls 的選項來指定搖骰子的方式,內容為“{N}d{M}”,表示 M 面的骰子搖 N 次,N 和 M 都是数字。在真正的處理 rolls 前,我們需要通過回調函數來校驗它的格式:

def validate_rolls(ctx, param, value):
    try:
        rolls, dice = map(int, value.split('d', 2))
        return (dice, rolls)
    except ValueError:
        raise click.BadParameter('rolls need to be in format NdM')

@click.command()
@click.option('--rolls', callback=validate_rolls, default='1d6')
def roll(rolls):
    click.echo('Rolling a %d-sided dice %d time(s)' % rolls)

這樣,當我們輸入錯誤格式時,變會校驗不通過:

$ roll --rolls=42
Usage: roll [OPTIONS]

Error: Invalid value for "--rolls": rolls need to be in format NdM

輸入正確格式時,則正常輸出信息:

$ roll --rolls=2d12
Rolling a 12-sided dice 2 time(s)

優先
通過 click.option 中的 is_eager 可以讓該選項成為優先選項,這意味着它會先於所有選項處理。

利用回調和優先選項,我們就可以很好地實現 --version 選項。不論命令行中寫了多少選項和參數,只要包含了 --version,我們就希望它打印版本就退出,而不執行其他選項的邏輯,那麼就需要讓它成為優先選項,並且在回調函數中打印版本。

此外,在 click 中每個選項都對應到命令處理函數的同名參數,如果不想把該選項傳遞到處理函數中,則需要指定 expose_value=True,於是有:

def print_version(ctx, param, value):
    if not value or ctx.resilient_parsing:
        return
    click.echo('Version 1.0')
    ctx.exit()

@click.command()
@click.option('--version', is_flag=True, callback=print_version,
              expose_value=False, is_eager=True)
def hello():
    click.echo('Hello World!')

當然 click 提供了便捷的 click.version_option 來實現 --version

@click.command()
@click.version_option(version='0.1.0')
def hello():
    pass

2.12 Yes 選項

基於前面的學習,我們可以實現 Yes 選項,也就是對於某些操作,不提供 --yes 則進行二次確認,提供了則直接操作:

def abort_if_false(ctx, param, value):
    if not value:
        ctx.abort()

@click.command()
@click.option('--yes', is_flag=True, callback=abort_if_false,
              expose_value=False,
              prompt='Are you sure you want to drop the db?')
def dropdb():
    click.echo('Dropped all tables!')

當然 click 提供了便捷的 click.confirmation_option 來實現 Yes 選項:

@click.command()
@click.confirmation_option(prompt='Are you sure you want to drop the db?')
def dropdb():
    click.echo('Dropped all tables!')

在命令行中調用則有:

$ dropdb
Are you sure you want to drop the db? [y/N]: n
Aborted!
$ dropdb --yes
Dropped all tables!

2.11 其他增強功能

click 支持從環境中讀取選項的值,這是 argparse 所不支持的,可參閱官方文檔的 和 。

click 支持指定選項前綴,你可以不使用 - 作為選項前綴,還可使用 +/,當然在一般情況下並不建議這麼做。詳情參閱官方文檔的

三、總結

可以看出,click 對命令行選項的支持非常豐富和強大,除了支持 argarse 所支持的所有選項類型外,還提供了諸如 計值選項特性切換選項提示選項 等更豐富的選項類型。此外,還提供了從環境中讀變量等方便易用的增強功能。簡直就是開發命令行程序的利器。

在下篇文章中,我們着重介紹下 click 的命令和組,這可是實現它的重要特性(任意嵌套命令)的方式。

『講解開源項目系列』——讓對開源項目感興趣的人不再畏懼、讓開源項目的發起者不再孤單。跟着我們的文章,你會發現編程的樂趣、使用和發現參与開源項目如此簡單。歡迎留言聯繫我們、加入我們,讓更多人愛上開源、貢獻開源~

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?

氣象專家警告 人為氣候變遷已和聖嬰現象一樣強

4{icon} {views}

環境資訊中心綜合外電;姜唯 編譯;林大利 審校

本站聲明:網站內容來源環境資訊中心https://e-info.org.tw/,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?

直接引用MrAdvice.dll文件不能實現AOP攔截,教你1分鐘解決這個問題

5{icon} {views}

直接引用MrAdvice.dll文件不能實現AOP攔截,教你1分鐘解決這個問題。近日工作中,要實現一個功能,那就是業務層方法裏面實現自動緩存。編寫業務的C#開發人員只關注如何將業務代碼編寫正確就可以了,而緩存的代碼,大多類似,無非就是判斷是否有緩存,有就取出返回,沒有就調用數據庫代碼獲取數據再緩存起來而已,於是這部分代碼通過使用AOP的方式自動接管掉這種重複性代碼。

MrAdvice開源項目github地址:

直接引用MrAdvice.dll文件不能實現AOP攔截功能

1月份的時候寫過一篇的文章,在測試程序中使用的是MrAdvice這個開源組件,對它熟悉,就又使用它了。只不過這次使用有點特殊,以前開發是可以聯網的,可以很方便的使用nuget將其安裝到本地,而這次是因項目原因內外網隔離,且是斷網開發的,就只能在外網寫個測試程序,然後將MrAdvice.dll文件複製到內網電腦,內網電腦通過引用dll的方式來使用該組件,結果是不會進入到攔截方法的。

直接引用MrAdvice.dll  

通過下圖可以看到,成功解決后,可以實現自動緩存了。

實現AOP攔截 

下面是全部的演示程序源碼。

演示程序解決方案目錄一覽

該項目是一個控制台項目,解決方案如下圖所示:

演示程序解決.

MrAdvice.dll是直接引用的,不是通過nuget安裝的,至於這個dll文件的獲取,你可以通過nuget獲取了找到它即可。

演示程序的源碼

控制台入口的代碼比較簡單,單純的調用接口。

程序入口代碼

class Program
    {
        static void Main(string[] args)
        {
            Console.Title = "jhrs.com AOP演示程序,通過直接引用MrAdvice.dll編寫的代碼!";
            DateTime dtNow = DateTime.Now;
            IJhrscom api = new Jhrscom();
            var result = api.GetResult("這是a參數", dtNow, 12342);
            Console.WriteLine();
            Console.WriteLine($"第1次調用時返回結果是:"+result.ToJson());
            Console.WriteLine();
            result = api.GetResult("這是a參數", dtNow, 12342);
            Console.WriteLine();
            Console.WriteLine($"第2次調用時返回結果是來自第1次緩存數據,只不過被改了下:" + result.ToJson());
            Console.WriteLine();
            //api.GetPatient(Guid.NewGuid(), result);
        }
    }

  

程序接口代碼

程序接口代碼主要是模擬業務方法裏面的一些類,定義了一個接口,一個實現類,另外實現類上面是標註了一個自動緩存的特性(AutoCache),該特性的實現代碼即為下面所述的核心的AOP攔截代碼,具體下面會給出的;另外還有一個輸出結果(響應消息)的類。整個源碼是放到一個文件裏面的,如下所示:

public interface IJhrscom
    {
        ResponseResult GetResult(string a, DateTime dateTime, int id);

        ResponseResult GetPatient(Guid id, ResponseResult t);
    }

    public class Jhrscom : IJhrscom
    {
        [AutoCache(10)]
        public ResponseResult GetPatient(Guid id, ResponseResult t)
        {
            string key = GetKey(new object[] { id, t });
            ResponseResult result = new ResponseResult() { Code = 4444, Message = "第2個方法" };
            return result;
        }

        [AutoCache(cacheMinutes: 12, enableSliding: true)]
        public ResponseResult GetResult(string a, DateTime dateTime, int id)
        {
            ResponseResult result = new ResponseResult() { Code = 1122, Message = "緩存測試消息" };
            string key = GetKey(new object[] { a, dateTime, id });
            return result;
        }

        /// <summary>
        /// 緩存key
        /// </summary>
        /// <param name="pars"></param>
        /// <returns></returns>
        private string GetKey(params object[] pars)
        {
            var method = new StackFrame(1).GetMethod();
            var array = method.GetParameters();
            var key = array.Select(x => { return pars[x.Position].ToJson(); }).ToArray();

            var cacheKey = $"{method.DeclaringType.ToString()}|{method.Name.Replace("′", "")}|{string.Join("_", array.Select(x => x.Name))}|{string.Join("_", key)}".GetMd5();
            Console.WriteLine($"【{method.Name.Replace("′", "")}】實現類裏面的緩存Key:" + cacheKey);
            return cacheKey;
        }
    }

    /// <summary>
    /// 輸出結果
    /// </summary>
    public class ResponseResult
    {
        public int Code { get; set; }
        public string Message { get; set; }

        //.....其它屬性
    }

  

核心的AOP攔截代碼

該代碼是用於實現自動緩存功能,思路就是在調用業務方法前,根據緩存key,緩存key按一定規則生成,保證唯一就可以了,具體源碼中有說明,從緩存裏面取出數據,如果存在緩存就直接返回給調用者即可,並終止業務方法的執行(體現在不調用context.Proceed()方法上);如果不存在緩存數據或者緩存過期了,則調用業務方法獲取數據后並緩存就可以了。

/// <summary>
    /// 用AOP來實現自動緩存
    /// </summary>
    public class AutoCacheAttribute : Attribute, IMethodAdvice
    {
        /// <summary>
        /// 滑動過期
        /// </summary>
        public bool EnableSliding { get; set; }

        /// <summary>
        /// 緩存時間,分鐘
        /// </summary>
        public int CacheMinutes { get; set; }

        /// <summary>
        /// 構造函數
        /// </summary>
        /// <param name="cacheMinutes">緩存時間,分鐘,默認5分鐘,小於等於0永久緩存</param>
        /// <param name="enableSliding">使用滑動過期緩存控制策略</param>
        public AutoCacheAttribute(int cacheMinutes = 5, bool enableSliding = false)
        {
            EnableSliding = enableSliding;
            CacheMinutes = cacheMinutes;
        }

        /// <summary>
        /// AOP組件攔截方法,用於實現自動緩存,有緩存時直接返回;
        /// 沒有緩存時,調用被攔截方法后,有返回值則將數據自動緩存起來
        /// </summary>
        /// <param name="context"></param>
        public void Advise(MethodAdviceContext context)
        {
            var key = GetKey(context);
            if (context.HasReturnValue && key.TryGetCache(out object m))
            {
                var r = m as ResponseResult;
                r.Message = "在攔截方法裏面改了緩存裏面取出來的數據!";

                context.ReturnValue = r;
                //context.ReturnValue = m;  

                //context.Proceed();  //直接取出緩存返回,不用執行原來取數據方法。
            }
            else
            {
                context.Proceed();//執行被攔截的方法
                if (context.HasReturnValue && context.ReturnValue != null)
                {
                    //被攔截方法有返回值,並且返回值不為null
                    if (EnableSliding && CacheMinutes > 0)
                        context.ReturnValue.SetCache(key, TimeSpan.FromMinutes(CacheMinutes));
                    else if (CacheMinutes > 0)
                        context.ReturnValue.SetCache(key, DateTime.Now.AddMinutes(CacheMinutes));
                    else
                        context.ReturnValue.SetCache(key);
                }
            }
        }

        /// <summary>
        /// 獲取緩存key,key的規則為: md5(類全名|方法名|參數列表拆分數組|參數值的json數組),這樣可以保證唯一
        /// </summary>
        /// <param name="context"></param>
        /// <returns></returns>
        private string GetKey(MethodAdviceContext context)
        {
            var array = context.TargetMethod.GetParameters();
            var key = array.Select(x => { return context.Arguments[x.Position].ToJson(); }).ToArray();

            var cacheKey = $"{context.Target.ToString()}|{context.TargetName}|{string.Join("_", array.Select(x => x.Name))}|{string.Join("_", key)}".GetMd5();
            return cacheKey;
        }
    }

    /// <summary>
    /// 緩存擴展方法,可使用其它緩存替代
    /// </summary>
    public static class CacheExtensions
    {
        private static MemoryCache cache = new MemoryCache("https://jhrs.com");

        /// <summary>
        /// 設置緩存,一直不過期
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="value"></param>
        /// <param name="key"></param>
        public static void SetCache<T>(this T value, string key)
        {
            if (string.IsNullOrWhiteSpace(key)) throw new ArgumentException($"緩存鍵參數{nameof(key)}不能為null或空");
            if (value == null) throw new ArgumentException($"緩存值參數{nameof(value)}不能為null");
            CacheItemPolicy policy = new CacheItemPolicy();
            cache.Set(key, value, policy);
        }

        /// <summary>
        /// 設置緩存,固定過期時間
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="value"></param>
        /// <param name="key"></param>
        /// <param name="absoluteExpiration"></param>
        public static void SetCache<T>(this T value, string key, DateTimeOffset? absoluteExpiration)
        {
            if (string.IsNullOrWhiteSpace(key)) throw new ArgumentException($"緩存鍵參數{nameof(key)}不能為null或空");
            if (value == null) throw new ArgumentException($"緩存值參數{nameof(value)}不能為null");
            CacheItemPolicy policy = new CacheItemPolicy() { AbsoluteExpiration = (DateTimeOffset)absoluteExpiration };
            cache.Set(key, value, policy);
        }

        /// <summary>
        /// 設置緩存,滑動過期
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="value"></param>
        /// <param name="key"></param>
        /// <param name="slidingExpiration"></param>
        public static void SetCache<T>(this T value, string key, TimeSpan? slidingExpiration)
        {
            if (string.IsNullOrWhiteSpace(key)) throw new ArgumentException($"緩存鍵參數{nameof(key)}不能為null或空");
            if (value == null) throw new ArgumentException($"緩存值參數{nameof(value)}不能為null");
            CacheItemPolicy policy = new CacheItemPolicy() { SlidingExpiration = (TimeSpan)slidingExpiration };
            cache.Set(key, value, policy);
        }

        /// <summary>
        /// 獲取緩存數據
        /// </summary>
        /// <typeparam name="T">對象類型</typeparam>
        /// <param name="key"><緩存key/param>
        /// <param name="value">返回的緩存數據對名</param>
        /// <returns></returns>
        public static bool TryGetCache<T>(this string key, out T value)
        {
            value = default(T);
            if (cache.Contains(key))
            {
                value = (T)cache.Get(key);
                return true;
            }
            return false;
        }

        /// <summary>
        /// 獲取字符串MD5值
        /// </summary>
        /// <param name="value"></param>
        /// <returns></returns>
        public static string GetMd5(this string value)
        {
            byte[] bytes = Encoding.UTF8.GetBytes(value);

            StringBuilder sb = new StringBuilder();
            MD5 hash = new MD5CryptoServiceProvider();
            bytes = hash.ComputeHash(bytes);
            foreach (byte b in bytes)
            {
                sb.AppendFormat("{0:x2}", b);
            }
            return sb.ToString();
        }
    }

  

附加的JSON擴展類

該擴展類只是方便將對象轉為JSON而已,代碼不復如,如下所示:

 public static class JsonExtensions
    {
        /// <summary>
        /// 將對象轉換為JSON字符串
        /// </summary>
        /// <param name="obj">要轉換的對象</param>
        /// <param name="camelCase">是否小寫名稱</param>
        /// <param name="indented"></param>
        /// <returns></returns>
        public static string ToJson(this object obj, bool camelCase = false, bool indented = false)
        {
            JsonSerializerSettings settings = new JsonSerializerSettings();
            if (camelCase)
            {
                settings.ContractResolver = new CamelCasePropertyNamesContractResolver();
            }
            if (indented)
            {
                settings.Formatting = Formatting.Indented;
            }
            return JsonConvert.SerializeObject(obj, settings);
        }

        /// <summary>
        /// 把Json字符串轉換為強類型對象
        /// </summary>
        public static T FromJson<T>(string json)
        {
            if (string.IsNullOrWhiteSpace(json)) return default(T);
            json = JsonDateTimeFormat(json);
            return JsonConvert.DeserializeObject<T>(json);
        }

        /// <summary>
        /// 處理Json的時間格式為正常格式
        /// </summary>
        private static string JsonDateTimeFormat(string json)
        {
            json = Regex.Replace(json,
                @"\\/Date\((\d+)\)\\/",
                match =>
                {
                    DateTime dt = new DateTime(1970, 1, 1);
                    dt = dt.AddMilliseconds(long.Parse(match.Groups[1].Value));
                    dt = dt.ToLocalTime();
                    return dt.ToString("yyyy-MM-dd HH:mm:ss.fff");
                });
            return json;
        }
    }

  

解決直接引用MrAdvice.dll不能攔截的問題

出現這個問題的根源是,MrAdvice這個組件是在編譯時會給你的項目源碼編織一些AOP攔截代碼,熟悉PostSharp的應該對此了解,這也是在MrAdvice項目地址的issues處得到解答,地址是:

所以我們需要在項目文件csproj裏面添加一些配置,並且把MrAdvice的目錄複製到斷網開發項目的packages目錄。通過完成這兩個步驟就可以解決了。

You’ve missed the point: Mr Advice is a post-build weaver, which changes the assembly at build-time after the csc compiler has generated it. To achieve this, is inserts a task in the csproj. So if you want to do the same manually, you need to also add the build task in your csproj. If you have a VS2017 solution with a project working, you’ll only need to copy the lines that were added to the csproj into your own project.

解決步驟

  • 聯網新建一個項目,通過nuget安裝MrAdvice,然後在解決方案的packages目錄裏面將nuget下載的MrAdvice目錄包,複製到你斷網環境的解決方案的packages目錄,如下圖所示:

MrAdvice 目錄

  • 修改項目文件,即修改csproj文件,csproj文件可以使用記事本或者其它軟件打開,增加以下節點,如下圖所示:

csproj文件

配置節點為如下:

<Import Project="..\packages\MrAdvice.2.8.8\build\MrAdvice.targets" Condition="Exists('..\packages\MrAdvice.2.8.8\build\MrAdvice.targets')" />
  <Target Name="EnsureNuGetPackageBuildImports" BeforeTargets="PrepareForBuild">
    <PropertyGroup>
      <ErrorText>這台計算機上缺少此項目引用的 NuGet 程序包。使用“NuGet 程序包還原”可下載這些程序包。有關更多信息,請參見 http://go.microsoft.com/fwlink/?LinkID=322105。缺少的文件是 {0}。</ErrorText>
    </PropertyGroup>
    <Error Condition="!Exists('..\packages\MrAdvice.2.8.8\build\MrAdvice.targets')" Text="$([System.String]::Format('$(ErrorText)', '..\packages\MrAdvice.2.8.8\build\MrAdvice.targets'))" />
  </Target>

  

好了,通過以上步驟就可以在斷網環境裏面愉快的使用MrAdvice這個AOP攔截組件來省點體力勞動了。

源碼可以在首發地址下載,本文首發於:

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?

BMW集團未來將削減50%燃油車款

4{icon} {views}

摘錄自2020年03月15日ETtoday報導

BMW集團近日公布財報,除了在2019年首度達成全集團(包括二輪、Mini與勞斯萊斯)獲利1,000億歐元(約3.3兆台幣)以上的新高紀錄外,同時也將自明年開始,削減50%的傳統內燃機動力系統,全力發展Hybrid油電混合與純電動EV車款。

根據BMW集團聲明稿內容,自2021年開始,BMW將淘汰多達50%的內燃機車款,並致力於電動化動力系統。雖然BMW並未說明是哪些車款會被淘汰,但這並不意味著現有車型會在幾年內馬上消失,不過可以確定的是,各車系的衍生車型將會縮減,並且不僅限於BMW品牌而已,包括Mini、勞斯萊斯也是。

BMW的電動化策略已在進行中,除了最近亮相的i4 Concept外,iX3與iNext電動休旅也即將在明年上市,而現有的i3則會持續販售至2024年,同時在許多3系列、5系列中也有許多PHEV插電式油電車型。在確定集團未來方向後,可以想見未來BMW的傳統燃油車款將會越來越少。

能源議題
國際新聞
BMW
燃油車
電動車
油電混合車

本站聲明:網站內容來源環境資訊中心https://e-info.org.tw/,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?

Spring Boot Actuator監控使用詳解

4{icon} {views}

在企業級應用中,學習了如何進行SpringBoot應用的功能開發,以及如何寫單元測試、集成測試等還是不夠的。在實際的軟件開發中還需要:應用程序的監控和管理。SpringBoot的Actuator模塊實現了應用的監控與管理。

Actuator簡介

生產系統中,往往需要對系統實際運行的情況(例如cpu、io、disk、db、業務功能等指標)進行監控運維。在SpringBoot項目中Actuator模塊提供了眾多HTTP接口端點(Endpoint),來提供應用程序運行時的內部狀態信息。

Actuator模塊提供了一個監控和管理生產環境的模塊,可以使用http、jmx、ssh、telnet等來管理和監控應用。包括應用的審計(Auditing)、健康(health)狀態信息、數據採集(metrics gathering)統計等監控運維的功能。同時,提供了可以擴展 Actuator端點(Endpoint)自定義監控指標。這些指標都是以JSON接口數據的方式呈現。

Actuator的使用

使用Spring Boot Actuator需要加入如下依賴:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

actuator並沒有默認集成在自動配置中,而在作為獨立的項目來呈現的。當引入了上面的依賴,默認會引入actuator相關的兩個項目:

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-actuator</artifactId>
</dependency>
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-actuator-autoconfigure</artifactId>
</dependency>

其中spring-boot-actuator為功能實現,spring-boot-actuator-autoconfigure為自動配置。

需要注意:因SpringBoot Actuator會暴露服務的詳細信息,為了保障安全性,建議添加安全控制的相關依賴spring-boot-starter-security,這樣在訪問應用監控端點時,都需要輸入驗證信息。所需依賴如下:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>

關於security的使用我們在此不進行展開,可在application文件中配置相應的訪問密碼:

spring:
  security:
    user:
      name: admin
      password: admin

在下面的內容中為了方便,我們暫時不引入security。

經過以上步驟的操作,啟動SpringBoot項目,actuator便自動集成配置了,可通過:http://localhost:8080/actuator 訪問,結果如下:

{
    "_links": {
        "self": {
            "href": "http://localhost:8080/actuator",
            "templated": false
        },
        "health": {
            "href": "http://localhost:8080/actuator/health",
            "templated": false
        },
        "health-component": {
            "href": "http://localhost:8080/actuator/health/{component}",
            "templated": true
        },
        "health-component-instance": {
            "href": "http://localhost:8080/actuator/health/{component}/{instance}",
            "templated": true
        },
        "info": {
            "href": "http://localhost:8080/actuator/info",
            "templated": false
        }
    }
}

默認支持的鏈接有:

/actuator
/actuator/health
/health/{component}/{instance}
/health/{component}
/actuator/info

可以在application配置文件中配置開啟更多的監控信息:

management:
  endpoints:
    web:
      exposure:
        include: '*'
#      base-path: /monitor
  endpoint:
    health:
      show-details: always
    shutdown:
      enabled: true
  • management.endpoints.web.exposure.include=’*’,代表開啟全部監控,也可僅配置需要開啟的監控,如: management.endpoints.web.exposure.include=beans,trace。
  • management.endpoint.health.show-details=always,health endpoint開啟显示全部細節。默認情況下/actuator/health是公開的,但不显示細節。
  • management.endpoints.web.base-path=/monitor,啟用指定的url地址訪問根路徑,默認路徑為/actuator/*,開啟則訪問路徑變為/monitor/*。
  • management.endpoint.shutdown.enabled=true,啟用接口關閉SpringBoot。

監控信息如果需要跨越調用,可通過CORS配置來支持,默認處於禁用狀態。設置management.endpoints.web.cors.allowed-origins屬性后開啟。

比如允許來自https://www.choupangxia.com 域的GET和POST調用:

management:
  endpoints:
    web:
      cors:
        allowed-origins: https://www.choupangxia.com
        allowed-methods: GET,POST

REST接口

Spring Boot Actuator提供了非常豐富的監控接口,可以通過這些接口了解應用程序運行時的內部狀況。Actuator也支持用戶自定義添加端點,可以根據實際應用,定義一些比較關心的指標,在運行期進行監控。

HTTP方法 路徑 描述
GET /auditevents 显示當前應用程序的審計事件信息
GET /beans 显示一個應用中所有Spring Beans的完整列表
GET /conditions 显示配置類和自動配置類(configuration and auto-configuration classes)的狀態及它們被應用或未被應用的原因。
GET /configprops 显示一個所有@ConfigurationProperties的集合列表
GET /env 显示來自Spring的ConfigurableEnvironment的屬性。
GET /flyway 显示數據庫遷移路徑,如果有的話。
GET /health 显示應用的健康信息(當使用一個未認證連接訪問時显示一個簡單的’status’,使用認證連接訪問則显示全部信息詳情)
GET /info 显示任意的應用信息
GET /liquibase 展示任何Liquibase數據庫遷移路徑,如果有的話
GET /metrics 展示當前應用的metrics信息
GET /mappings 显示一個所有@RequestMapping路徑的集合列表
GET /scheduledtasks 显示應用程序中的計劃任務
GET /sessions 允許從Spring會話支持的會話存儲中檢索和刪除(retrieval and deletion)用戶會話。使用Spring Session對反應性Web應用程序的支持時不可用。
POST /shutdown 允許應用以優雅的方式關閉(默認情況下不啟用)
GET /threaddump 執行一個線程dump

如果使用web應用(Spring MVC, Spring WebFlux, 或者 Jersey),還可以使用以下接口:

HTTP方法 路徑 描述
GET /heapdump 返回一個GZip壓縮的hprof堆dump文件
GET /jolokia 通過HTTP暴露JMX beans(當Jolokia在類路徑上時,WebFlux不可用)
GET /logfile 返回日誌文件內容(如果設置了logging.file或logging.path屬性的話),支持使用HTTP Range頭接收日誌文件內容的部分信息
GET /prometheus 以可以被Prometheus服務器抓取的格式显示metrics信息

接口詳解

health主要用來檢查應用的運行狀態,這是使用頻次最高的監控點。通常使用此接口显示應用實例的運行狀態,以及應用不“健康”的原因,比如數據庫連接、磁盤空間不夠等。

默認情況下health的狀態是開放的,訪問:http://localhost:8080/actuator/health 即可看到應用的狀態。

{
    "status" : "UP"
}

設置狀態碼順序:setStatusOrder(Status.DOWN,Status.OUT_OF_SERVICE, Status.UP, Status.UNKNOWN)。
過濾掉不能識別的狀態碼。如果無任何狀態碼,整個SpringBoot應用的狀態是UNKNOWN。將所有收集到的狀態碼排序。返回有序狀態碼序列中的第一個狀態碼,作為整個SpringBoot應用的狀態。

Health通過合併幾個健康指數檢查應用的健康情況。SpringBoot Actuator會自動配置以下內容:

名稱 描述
CassandraHealthIndicator 檢查Cassandra數據庫是否已啟動。
CouchbaseHealthIndicator 檢查Couchbase群集是否已啟動。
DiskSpaceHealthIndicator 檢查磁盤空間不足。
DataSourceHealthIndicator 檢查是否可以建立連接DataSource。
ElasticsearchHealthIndicator 檢查Elasticsearch集群是否已啟動。
InfluxDbHealthIndicator 檢查InfluxDB服務器是否已啟動。
JmsHealthIndicator 檢查JMS代理是否啟動。
MailHealthIndicator 檢查郵件服務器是否已啟動。
MongoHealthIndicator 檢查Mongo數據庫是否已啟動。
Neo4jHealthIndicator 檢查Neo4j服務器是否已啟動。
RabbitHealthIndicator 檢查Rabbit服務器是否已啟動。
RedisHealthIndicator 檢查Redis服務器是否啟動。
SolrHealthIndicator 檢查Solr服務器是否已啟動。

可以通過設置 management.health.defaults.enabled屬性來全部禁用。

原生端點

原生端點分為三大類:

  • 應用配置類:獲取應用程序中加載的應用配置、環境變量、自動化配置報告等與Spring Boot應用密切相關的配置類信息。
  • 度量指標類:獲取應用程序運行過程中用於監控的度量指標,比如:內存信息、線程池信息、HTTP請求統計等。
  • 操作控制類:提供了對應用的關閉等操作類功能。

應用配置類

/conditions:該端點用來獲取應用的自動化配置報告,其中包括所有自動化配置的候選項。同時還列出了每個候選項自動化配置的各個先決條件是否滿足。該端點可以幫助我們方便的找到一些自動化配置為什麼沒有生效的具體原因。

該報告內容將自動化配置內容分為兩部分:positiveMatches中返回的是條件匹配成功的自動化配置和negativeMatches中返回的是條件匹配不成功的自動化配置。

部分代碼如下:

"contexts": {
        "application": {
            "positiveMatches": {
                "MsgAutoConfiguration": [
                    {
                        "condition": "OnClassCondition",
                        "message": "@ConditionalOnClass found required class 'com.secbro2.msg.MsgService'"
                    }
                ],
                "MsgAutoConfiguration#msgService": [
                    {
                        "condition": "OnPropertyCondition",
                        "message": "@ConditionalOnProperty (msg.enabled=true) matched"
                    },
                    {
                        "condition": "OnBeanCondition",
                        "message": "@ConditionalOnMissingBean (types: com.secbro2.msg.MsgService; SearchStrategy: all) did not find any beans"
                    }
                ],

/info:就是在配置文件中配置的以info開頭的信息,如配置為:

info:
  app:
    name: spring-boot-actuator
    version: 1.0.0

返回結果:

{
  "app":{
    "name":"spring-boot-actuator",
    "version":"1.0.0"
  }
}

info中配置的參數也可以通過符號*@*包圍的屬性值來自pom.xml文件中的元素節點。如下:

info:
    build:
        artifact: @project.artifactId@
        name: @project.name@
        description: @project.description@
        ersion: @project.version@

返回結果:

{
    "build": {
        "artifact": "spring-learn",
        "name": "spring-learn",
        "description": "Demo project for Spring Boot",
        "ersion": "0.0.1-SNAPSHOT"
    }
}

/beans:該端點用來獲取應用上下文中創建的所有Bean。

{
    "contexts": {
        "application": {
            "beans": {
                "endpointCachingOperationInvokerAdvisor": {
                    "aliases": [],
                    "scope": "singleton",
                    "type": "org.springframework.boot.actuate.endpoint.invoker.cache.CachingOperationInvokerAdvisor",
                    "resource": "class path resource [org/springframework/boot/actuate/autoconfigure/endpoint/EndpointAutoConfiguration.class]",
                    "dependencies": ["environment"]
                },
                "defaultServletHandlerMapping": {
                    "aliases": [],
                    "scope": "singleton",
                    "type": "org.springframework.web.servlet.HandlerMapping",
                    "resource": "class path resource [org/springframework/boot/autoconfigure/web/servlet/WebMvcAutoConfiguration$EnableWebMvcConfiguration.class]",
                    "dependencies": []
                },
            },
            "parentId": null
        }
    }
}

接口展現了bean的別名、類型、是否單例、類的地址、依賴等信息。

/configprops:該端點用來獲取應用中配置的屬性信息報告。

{
    "spring.transaction-org.springframework.boot.autoconfigure.transaction.TransactionProperties": {
        "prefix": "spring.transaction",
        "properties": {}
    }
}

上面展示了TransactionProperties屬性的配置信息。

/mappings:該端點用來返回所有SpringMVC的控制器映射關係報告。

{
  "handler": "Actuator web endpoint 'beans'",
  "predicate": "{GET /actuator/beans, produces [application/vnd.spring-boot.actuator.v2+json || application/json]}",
  "details": {
    "handlerMethod": {
      "className": "org.springframework.boot.actuate.endpoint.web.servlet.AbstractWebMvcEndpointHandlerMapping.OperationHandler",
      "name": "handle",
      "descriptor": "(Ljavax/servlet/http/HttpServletRequest;Ljava/util/Map;)Ljava/lang/Object;"
    },
    "requestMappingConditions": {
      "consumes": [],
      "headers": [],
      "methods": ["GET"],
      "params": [],
      "patterns": ["/actuator/beans"],
      "produces": [{
        "mediaType": "application/vnd.spring-boot.actuator.v2+json",
        "negated": false
      }, {
        "mediaType": "application/json",
        "negated": false
      }]
    }
  }
}

/env:該端點與/configprops不同,它用來獲取應用所有可用的環境屬性報告。包括:環境變量、JVM屬性、應用的配置配置、命令行中的參數。

度量指標類

應用配置類提供的指標為靜態報告,而度量指標類端點提供的報告內容則是動態變化的,提供了應用程序在運行過程中的一些快照信息,比如:內存使用情況、HTTP請求統計、外部資源指標等。這些端點對於構建微服務架構中的監控系統非常有幫助。

/metrics:該端點用來返回當前應用的各類重要度量指標,比如:內存信息、線程信息、垃圾回收信息等。

{
    "names": [
        "jvm.memory.max",
        "jvm.threads.states",
        "http.server.requests",
        "process.files.max",
        "jvm.gc.memory.promoted",
        "system.load.average.1m",
        "jvm.memory.used",
        "jvm.gc.max.data.size",
        "jvm.gc.pause",
        "jvm.memory.committed",
        "system.cpu.count",
        "logback.events",
        "tomcat.global.sent",
        "jvm.buffer.memory.used",
        "tomcat.sessions.created",
        "jvm.threads.daemon",
        "system.cpu.usage",
        "jvm.gc.memory.allocated",
        "tomcat.global.request.max",
        "tomcat.global.request",
        "tomcat.sessions.expired",
        "jvm.threads.live",
        "jvm.threads.peak",
        "tomcat.global.received",
        "process.uptime",
        "tomcat.sessions.rejected",
        "process.cpu.usage",
        "tomcat.threads.config.max",
        "jvm.classes.loaded",
        "jvm.classes.unloaded",
        "tomcat.global.error",
        "tomcat.sessions.active.current",
        "tomcat.sessions.alive.max",
        "jvm.gc.live.data.size",
        "tomcat.threads.current",
        "process.files.open",
        "jvm.buffer.count",
        "jvm.buffer.total.capacity",
        "tomcat.sessions.active.max",
        "tomcat.threads.busy",
        "process.start.time"
    ]
}

從上面的示例中有這些重要的度量值:

  • 系統信息:包括處理器數量processors、運行時間uptime和instance.uptime、系統平均負載systemload.average。
  • mem.*:內存概要信息,包括分配給應用的總內存數量以及當前空閑的內存數量。這些信息來自java.lang.Runtime。
  • heap.*:堆內存使用情況。這些信息來自java.lang.management.MemoryMXBean接口中getHeapMemoryUsage方法獲取的java.lang.management.MemoryUsage。
  • nonheap.*:非堆內存使用情況。這些信息來自java.lang.management.MemoryMXBean接口中getNonHeapMemoryUsage方法獲取的java.lang.management.MemoryUsage。
  • threads.*:線程使用情況,包括線程數、守護線程數(daemon)、線程峰值(peak)等,這些數據均來自java.lang.management.ThreadMXBean。
  • classes.*:應用加載和卸載的類統計。這些數據均來自java.lang.management.ClassLoadingMXBean。
  • gc.*:垃圾收集器的詳細信息,包括垃圾回收次數gc.ps_scavenge.count、垃圾回收消耗時間gc.ps_scavenge.time、標記-清除算法的次數gc.ps_marksweep.count、標記-清除算法的消耗時間gc.ps_marksweep.time。這些數據均來自java.lang.management.GarbageCollectorMXBean。
  • httpsessions.*:Tomcat容器的會話使用情況。包括最大會話數httpsessions.max和活躍會話數httpsessions.active。該度量指標信息僅在引入了嵌入式Tomcat作為應用容器的時候才會提供。
  • gauge.*:HTTP請求的性能指標之一,它主要用來反映一個絕對數值。比如上面示例中的gauge.response.hello: 5,它表示上一次hello請求的延遲時間為5毫秒。
  • counter.*:HTTP請求的性能指標之一,它主要作為計數器來使用,記錄了增加量和減少量。如上示例中counter.status.200.hello: 11,它代表了hello請求返回200狀態的次數為11。

/threaddump:會生成當前線程活動的快照。方便我們在日常定位問題的時候查看線程的情況。主要展示了線程名、線程ID、線程的狀態、是否等待鎖資源等信息。

{
    "threads": [{
        "threadName": "Reference Handler",
        "threadId": 2,
        "blockedTime": -1,
        "blockedCount": 2,
        "waitedTime": -1,
        "waitedCount": 0,
        "lockName": null,
        "lockOwnerId": -1,
        "lockOwnerName": null,
        "daemon": true,
        "inNative": false,
        "suspended": false,
        "threadState": "RUNNABLE",
        "priority": 10,
        "stackTrace": [{
            "classLoaderName": null,
            "moduleName": "java.base",
            "moduleVersion": "11.0.4",
            "methodName": "waitForReferencePendingList",
            "fileName": "Reference.java",
            "lineNumber": -2,
            "className": "java.lang.ref.Reference",
            "nativeMethod": true
        }
  ...
  "lockedMonitors": [],
        "lockedSynchronizers": [{
            "className": "java.util.concurrent.locks.ReentrantLock$NonfairSync",
            "identityHashCode": 2060076420
        }],
        "lockInfo": null
  ...
  {
        "threadName": "DestroyJavaVM",
        "threadId": 42,
        "blockedTime": -1,
        "blockedCount": 0,
        "waitedTime": -1,
        "waitedCount": 0,
        "lockName": null,
        "lockOwnerId": -1,
        "lockOwnerName": null,
        "daemon": false,
        "inNative": false,
        "suspended": false,
        "threadState": "RUNNABLE",
        "priority": 5,
        "stackTrace": [],
        "lockedMonitors": [],
        "lockedSynchronizers": [],
        "lockInfo": null
    }]
}

/trace:該端點用來返回基本的HTTP跟蹤信息。默認情況下,跟蹤信息的存儲採用。

操作控制類

/shutdown:配置文件中配置開啟此功能:

management.endpoint.shutdown.enabled=true

使用 curl 模擬 post 請求此接口:

curl -X POST "http://localhost:8080/actuator/shutdown"

显示結果為:

{
    "message": "Shutting down, bye..."
}

小結

本篇文章介紹了SpringBoot Actuator監控的基本功能和詳解,下篇文章將會帶大家了解一下該功能在Spring Boot中的實現原理。歡迎關注公眾號“程序新視界”。

原文鏈接:《》

程序新視界:精彩和成長都不容錯過

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?

葉門僅1/3人口有自來水 洗手防疫都奢侈

3{icon} {views}

摘錄自2020年3月24日中央社報導

武漢肺炎防疫戰中,當前最重要的指令是勤洗手。但在戰火摧殘的葉門,乾淨用水極度稀缺,洗手是令數百萬人負擔不起的奢侈動作。法新社報導,葉門崩壞的醫療系統尚未記錄到任何俗稱武漢肺炎的確診病例,但若這波大流行病真的入侵葉門,對這個五年來衝突不斷、被聯合國稱為全球最嚴重人道危機的國家,將造成難以想像的影響。

無國界醫生組織(MSF)擔心許多葉門人無法取得乾淨水源或肥皂。根據聯合國兒童基金會(UNICEF)2019年11月提出的「葉門危機」報告,葉門約2800萬人口中,將近1800萬人無法正常取得安全水源,包括920萬名兒童,且僅有1/3人口能取得自來水。

水文
土地水文
國際新聞
葉門
水資源短缺
自來水
洗手

本站聲明:網站內容來源環境資訊中心https://e-info.org.tw/,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※想知道網站建置網站改版該如何進行嗎?將由專業工程師為您規劃客製化網頁設計後台網頁設計

※不管是台北網頁設計公司台中網頁設計公司,全省皆有專員為您服務

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※帶您來看台北網站建置台北網頁設計,各種案例分享

小三通物流營運型態?

※快速運回,大陸空運推薦?