Java protobuf
2021年6月10日 星期四
2021年6月3日 星期四
在 OracleLinux 上安裝 oracle database (19c)
oracle 是透過 oracle-database-preinstall 和 oracle-database-ee 的
rpm 安裝,所以會少掉很多設定的地方,像是環境變數,新建 linux 的 group 和
user 之類的部份。
環境:
y04 是 linux 使用者的 id
在 VMWare 下新安裝的 OracleLinux (OracleLinux-R8-U4-x86_64-dvd_iso)
已安裝 JAVA JDK
用到的檔案,下載到 \home\y04\Downloads,這個位置
compat-libcap1-1.10-7.el7.x86_64.rpm
http://mirror.centos.org/centos/7/os/x86_64/Packages/compat-libstdc++-33-3.2.3-72.el7.x86_64.rpm
compat-libstdc++-33-3.2.3-72.el7.x86_64.rpm
http://mirror.centos.org/centos/7/os/x86_64/Packages/compat-libcap1-1.10-7.el7.x86_64.rpm
oracle-database-preinstall-19c-1.0-1.el7.x86_64.rpm
https://yum.oracle.com/repo/OracleLinux/OL7/latest/x86_64/getPackage/oracle-database-preinstall-19c-1.0-1.el7.x86_64.rpm
oracle-database-ee-19c-1.0-1.x86_64.rpm
oracle 官網自行下載
過程(安裝 database)
透過內建的 firefox 把下列檔案抓回來
oracle database 要用到的套件
http://mirror.centos.org/centos/7/os/x86_64/Packages/compat-libstdc++-33-3.2.3-72.el7.x86_64.rpm
http://mirror.centos.org/centos/7/os/x86_64/Packages/compat-libcap1-1.10-7.el7.x86_64.rpm
oracle preinstall 會幫忙處理一些新增 group 和 user 的動作
https://yum.oracle.com/repo/OracleLinux/OL7/latest/x86_64/getPackage/oracle-database-preinstall-19c-1.0-1.el7.x86_64.rpm
oracle database 本體,直接到 oracle 官網自行下載
oracle-database-ee-19c-1.0-1.x86_64.rpm
以下所有操作均在 terminal 下執行
關防火牆
systemctl stop firewalld.service
關防火牆的自動啟動
systemctl disable firewalld.service
檢查關閉狀態
systemctl status firewalld.service
dead 表示未啟動開啟啟動、inactive 表示現在是關閉
安裝相依套件
sudo yum install libstdc++-devel ksh glibc-devel libaio-devel
sudo yum localinstall /home/y04/Downloads/compat-libstdc++-33-3.2.3-72.el7.x86_64.rpm
sudo yum localinstall /home/y04/Downloads/compat-libcap1-1.10-7.el7.x86_64.rpm
安裝 oracle database preinstall
sudo yum localinstall /home/y04/Downloads/oracle-database-preinstall-19c-1.0-1.el7.x86_64.rpm
配置 oracle 帳號的環境變量 (preinstall 會在 linux 新增一個名字叫 oracle 的帳戶)
su - root //切換到 root 帳號
passwd oracle //重設 oracle 密碼為 123
su - oracle //切換到 oracle 帳號
vi ~/.bash_profile //用 vim 開 .bash_profile
確認下面設定有在 .bash_profile
export ORACLE_BASE=/opt/oracle
export ORACLE_HOME=/opt/oracle/product/19c/dbhome_1
export PATH=$ORACLE_HOME/bin:$PATH
export ORACLE_SID=ORCLCDB
#防止安裝過程出現亂碼
export LANG=en_US.UTF-8
#設定Oracle使用者端字元集,必須與Oracle安裝時設定的字元集保持一致,
export NLS_LANG=AMERICAN_AMERICA.AL32UTF8
su - root //切換到 root 帳號
安裝 oracle database
sudo yum localinstall /home/y04/Downloads/oracle-database-ee-19c-1.0-1.x86_64.rpm
配置腳本 (簡單檢查一下腳本內容,可以略過)
su – root
cd /etc/init.d/
vi oracledb_ORCLCDB-19c
執行腳本前置 (執行腳本之前的動作,主要是應對一些執行腳本過程中可能發生的問題)
對應「java.library.path 系統變數遺漏或無效」
(The java.library.path system variable is missing or invalid. Please set java.library.path with a correct value and retry the operation.)
yum install libnsl
對應「檔案 "/etc/oratab" 無法存取.」
(File "etc/oratab" is not accessible)
這個異常好像不會中斷腳本的執行
解法參考(https://www.cnblogs.com/datalife/archive/2011/03/15/1985253.html)
原因是安裝 oracle database 的時候,少 執行一個 root.sh
cd /opt/oracle/product/19c/dbhome_1/
./root.sh
執行腳本
su – root
cd /etc/init.d/
./oracledb_ORCLCDB-19c configure
重開機
過程(建立 database 到 client 可連入)
改 listener.ora 為允許 client 連入
修改 listener.ora 的內容,將原本的
listener.ora 的位置應該在 \opt\oracle\product\19c\dbhome_1\network\admin
LISTENER =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))
)
)
改成
LISTENER =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = 0.0.0.0)(PORT = 1521))
(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))
)
)
然後啟動或重啟 listener
lsnrctl status //oracle database listener 查詢狀態
> lsnrctl start //oracle database listener 啟動
lsnrctl stop //oracle database listener 停止
> lsnrctl reload //oracle database listener 重啟
啟動及設定 oracle
su - oracle
sqlplus / as sysdba
--啟動 database
--未啟動的錯誤 ORA-01034: ORACLE not available
SQL>startup;
SQL>alter database open;
SQL>exit;
--修改 datbase 的 sys 和 system 這兩個使用者的密碼,都改成 abc
SQL>alter user system identified by "abc";
SQL>alter user sys identified by "abc";
--查當前 sid
SQL>select instance from v$thread; --return ORCLCDB
or
SQL>select * from v$version;
SQL>select sys_context('userenv','instance_name') from dual; --return ORCLCDB
到這步應該外部就可以連入
測試用的軟體 (DBeaver)
host: 192.168.1.113 //看你自己的 linux ip
port: 1521 //oracle default
database (=sid=service): ORCLCDB //前面步驟查的
username: system //內建的
password: abc //前面設的
到這邊如果都順利的話就可以連入 oracle database 中了,接下來就是建立自己要用的測試資料庫
su - oracle
sqlplus / as sysdba
-- 確認 database 啟動了
SQL>startup;
SQL>alter database open; --or SQL>alter pluggable database all open;
SQL>select * from v$version; --先查當前版本,讓 dual 有東西
SQL>select sys_context ('USERENV', 'CON_NAME') from dual; --知道當前容器在 CDB$ROOT
SQL>select pdb from v$services; --查有那些 pdb,應廳會有一個 ORCLPDB1
or
SQL>show pdbs;
SQL>alter session set container=ORCLPDB1; --把 session 指定到 PDB
SQL>alter database open;
SQL>create user y04 identified by "y04"; --在當前 session 中建立一個 y04 且密碼為 y04 的帳號
SQL>grant dba to y04; --設定 y04 的資料庫權限,正常是不會直接給 dba 這個權限,不過我還不熟,先這樣吧
然後外部就可以用 y04 了,一樣外部用 DBeaver 連入
測試用的軟體 (DBeaver)
host: 192.168.1.113 //看你自己的 linux ip
port: 1521 //oracle default
database (=sid=service): orclpdb1 //就是pdb,因為剛剛已經把 session 切到這個 pdb 了,所以要改用這個
username: y04
password: y04
註1 本機 sqlplus 登入 y04 的方式
sqlplus 帳號/密碼@host/database(=sid=service)
sqlplus y04/y04@localhost/orclpdb1
註2 .base_profile
#oracle資料庫安裝目錄
export ORACLE_BASE=/opt/oracle
#oracle資料庫路徑
export ORACLE_HOME=$ORACLE_BASE/product/19c/dbhome_1
#oracle啟動資料庫範例名
export ORACLE_SID=ORCLCDB
#xterm視窗模式安裝
export ORACLE_TERM=xterm
#設定時間格式
NLS_DATE_FORMAT="YYYY:MM:DDHH24:MI:SS"
#新增系統環境變數
export PATH=$ORACLE_HOME/bin:/usr/sbin:$PATH
#新增系統環境變數
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:/lib:/usr/lib
#防止安裝過程出現亂碼
#export LANG=en_US.gbk
export LANG=en_US.UTF-8
#設定Oracle使用者端字元集,必須與Oracle安裝時設定的字元集保持一致,
export NLS_LANG=AMERICAN_AMERICA.AL32UTF8
2018年6月21日 星期四
Swashbuckle (3) 顯示 webapi 方法上 xml 的摘要
環境:vs2017、.net framework 4.7、Swashbuckle 5.6.0
首先建立好一個 WebApi 專案和透過 Nuget 裝好 Swashbuckle,並且透過
http://localhost:xxxxx/swagger 能夠進到 Swashbuckle 的頁面。
本篇的目的在於讓 Api 上面的 xml 註解中的資訊出現在 swagger 的頁面上
在安裝好 swashbuckle 後開啟 App_Start 中的 SwaggerConfig.cs,這個檔案
應該在 Nuget 安裝好 Swashbuckle 時就自動產生。
取消 SwaggerConfig.cs 中的下面這一行的註解
c.IncludeXmlComments(GetXmlCommentsPath());
在同一個 Class ( public class SwaggerConfig ) 下增加方法
internal static string GetXmlCommentsPath()
{
//透過設定專案的屬性,設定在建置後生成 XmlDocument.xml,
//此處是設定 Swagger 參考這份 xml
return string.Format(@"{0}\App_Data\XmlDocument.xml",
System.AppDomain.CurrentDomain.BaseDirectory);
}
圖上刪了很多原本是註解掉的部份
/// <summary>
/// 人員
/// </summary>
public class Person
{
/// <summary>
/// 人員名稱
/// </summary>
public string Name { get; set; }
/// <summary>
/// 人員年紀
/// </summary>
public int Age { get; set; }
}
/// <summary>
/// 錯誤狀態
/// </summary>
public class ErrorStatus
{
/// <summary>
/// 狀態代碼
/// </summary>
public string StatusCode { get; set; }
/// <summary>
/// 狀態描述
/// </summary>
public string Description { get; set; }
}
public class PeopleController : ApiController
{
/// <summary>
/// 取得人員資料
/// </summary>
/// <remarks>
/// 取得人員資料 api 的補充說明
/// </remarks>
/// <param name="id">人員 Id</param>
/// <response code="200">成功</response>
/// <response code="404">找不到</response>
/// <response code="500">內部伺服器錯誤</response>
[ResponseType(typeof(Person))]
public IHttpActionResult Get(string id)
{
return Ok(new Person());
}
}
如果設定了 [ResponseType(typeof(Person))] 因為他預設是在 Http Status 200
的時候所回傳的類別,所以需要同時設定 <response code="200">成功</response>
才會正常顯示 [ResponseType(typeof(Person))] 的部份
在傳入值或回傳值,切換到 Model 下時會顯示定義在 DataModel 上的 <summary> 訊息
執行專案,然後接下來進到 Swagger 頁面就可以看到 webapi 上設定的 xml 註解的資訊
在比較新版的 Swashbuckle 中,可以利用 SwaggerResponse 這個 attribute 來取代
<response code=""></response>
public class PeopleController : ApiController
{
/// <summary>
/// 取得人員資料
/// </summary>
/// <remarks>
/// 取得人員資料 api 的補充說明
/// </remarks>
/// <param name="id">人員 Id</param>
[SwaggerResponse(HttpStatusCode.OK, Description = "成功", Type = typeof(Person))]
[SwaggerResponse(HttpStatusCode.NotFound, Description = "找不到")]
[SwaggerResponse(HttpStatusCode.InternalServerError, Description = "內部伺服器錯誤", Type = typeof(ErrorStatus))]
[ResponseType(typeof(Person))]
public IHttpActionResult Get(string id)
{
return Ok(new Person());
}
}
2018年6月20日 星期三
Swashbuckle (1) 基本使用
Swashbuckle,其實就是 Swagger,基本上是一套產生線上 API
文件的產生器,線上文件(網頁)同時也可以產生一個呼叫 API 的頁面。
在實際使用上有很多不同的進階選項可以使用,本篇只說明最基礎的部份。
建立一個 WebApi 專案,在專案中建立 PeopleController
PeopleController.cs
public class PeopleController : ApiController
{
/// <summary>
/// 取得人員資料
/// </summary>
/// <returns></returns>
public string Get(string id)
{
return ("Ricky");
}
/// <summary>
/// 新增人員資料
/// </summary>
/// <returns></returns>
public HttpResponseMessage Post(Person person)
{
return Request.CreateResponse(
HttpStatusCode.Created, new { Status = "OK" });
}
}
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
透過 Nuget 安裝套件 Swashbuckle 和 Swashbuckle.Core Swashbuckle 相依於 Swashbuckle.Core 所以實際上裝 Swashbuckle 另 一個會自已裝好。
安裝好後直接執行專案
然後網址輸入 http://localhost:xxxxx/swagger,就能開啟 WebApi 文件的介面
輸入好參數(如果該 api 需要),點下面的 try out 就能呼叫 api
以上就是最基本的使用部份,Swashbuckle 依照 Api Controlle 中的基本資訊
(ex. 參數、回傳值)等,生成頁面上的資訊,但諸如方法上的 <summary> 註解
等都不會反應到頁面上。
Swashbuckle (2) 利用設定 ResponseType 告知 swagger 實際上回傳的型別為何
告知 swagger 實際上回傳的型別為何。
環境:vs2017、.net framework 4.7、Swashbuckle 5.6.0
透過 ResponseType 屬性,控制 Swagger 頁面所顯示的資訊
WebApi 的內容
//ResponseType 的 namespace 是 System.Web.Http.Description
using System.Web.Http.Description;
public class ValuesController : ApiController {
[ResponseType(typeof(Person))]
public IHttpActionResult Get(string id)
{
return Ok(new Person());
}
}
加上 [ResponseType(typeof(Person))] 前後的比對,可以透過 Model 和 Example Value 的切換
切換樣本和回傳的 Model 的定義。
2018年6月12日 星期二
[Visual Studio] 同時輸出到不同的目標 Framework
<PropertyGroup> <TargetFramework>netstandard2.0</TargetFramework> </PropertyGroup>
<PropertyGroup> <TargetFrameworks>net45;netstandard1.1</TargetFrameworks> </PropertyGroup>
2018年6月9日 星期六
[jQuery] validate.unobtrusive 驗證(3) 自訂驗證
基本
$.validator.addMethod 和 $.validator.unobtrusive.adapters.add
需要在載入 DOM 之前就先執行
下面的例子包括
不額外傳入驗證條件
傳入一個驗證條件
傳入多個驗證條件
不額外傳入驗證條件(ex.自定用來比對的上限/下限值)的例子,本例中假設
欄位字元長度不能超過5
validator.addMethod() 裡的 stringlengthcheck 對應到 html tag 裡的 data-val-stringlengthcheck
<head>
<script>
//stringlengthcheck 是在 html tag 中對應的 data-val-stringlengthcheck
$.validator.addMethod('stringlengthcheck', function (value, element, params) {
//假設驗證欄位不可大於5
return value.length <= 5;
});
//因為沒有要多傳參數做判斷,所以在 adapters.add 中沒有特別處理
//為了要做 unobtrusive 的設定
$.validator.unobtrusive.adapters.add("stringlengthcheck", function (options) {
options.rules["stringlengthcheck"] = {
};
options.messages["stringlengthcheck"] = options.message;
});
</script>
</head>
<body>
<input type="text" value="" name="money" id="money" data-val="true" data-val-stringlengthcheck="字元長度限制" />
<span data-valmsg-for="money" data-valmsg-replace="true"></span>
</body>
<head>
<script>
//傳入一個額外驗證條件
//data-val-stringlengthcheck="錯誤訊息" 會觸發驗證
//$.validator.addMethod 的 stringlengthcheck 要對應到 html tag 的 data-val-stringlengthcheck
$.validator.addMethod('stringlengthcheck', function (value, element, params)
{
//驗證條件,欄位內容長度需要小於
return value.length <= params["myMaxValue"];
});
//$.validator.unobtrusive.adapters.add 的 ["myMaxValue"] 對應到 html tag 的 data-val-stringlengthcheck-myMaxValue
$.validator.unobtrusive.adapters.add("stringlengthcheck", ["myMaxValue"], function (options)
{
//要指定參數,在 validator 裡才接的到
options.rules["stringlengthcheck"] = {
myMaxValue: options.params.myMaxValue
};
options.messages["stringlengthcheck"] = options.message;
});
</script>
</head>
<body>
<input type="text" name="myValue1" id="myValue1"
data-val="true"
data-val-stringlengthcheck="超過上限"
data-val-stringlengthcheck-myMaxValue=10 />
<span data-valmsg-for="myValue1" data-valmsg-replace="true"></span>
</body>
<head>
<script>
$.validator.addMethod('stringlengthcheck', function (value, element, params)
{
return value.length >= params["myValue1"] && value.length <= params["myValue2"];
});
//參數用 ["myValue1","myValue2"] 對應到 html tag 就是
//data-val-stringlengthcheck-myValue1 和 data-val-stringlengthcheck-myValue2
$.validator.unobtrusive.adapters.add("stringlengthcheck", ["myValue1","myValue2"], function (options)
{
var params ={
myValue1: options.params.myValue1,
myValue2: options.params.myValue2
}
options.rules["stringlengthcheck"] = params;
options.messages["stringlengthcheck"] = options.message;
});
</script>
</head>
<body>
<input type="text" value="" name="myValue" id="myValue" data-val="true"
data-val-stringlengthcheck="超過上下限"
data-val-stringlengthcheck-myValue1=1
data-val-stringlengthcheck-myValue2=2 />
<span data-valmsg-for="myValue" data-valmsg-replace="true"></span>
</body>




