blob: 54400cde091e2fdf0d1d2e2ecd6dc93c6d171fb3 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="zh">
<head>
<!-- Generated by javadoc -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>SqlTypeCoercionRule (Apache Calcite calcite API)</title>
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
<script type="text/javascript" src="../../../../../script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="SqlTypeCoercionRule (Apache Calcite calcite API)";
}
}
catch(err) {
}
//-->
var methods = {"i0":10,"i1":9,"i2":9};
var tabs = {65535:["t0","所有方法"],1:["t1","静态方法"],2:["t2","实例方法"],8:["t4","具体方法"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</script>
<noscript>
<div>您的浏览器已禁用 JavaScript。</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="跳过导航链接">跳过导航链接</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="导航">
<li><a href="../../../../../overview-summary.html">概览</a></li>
<li><a href="package-summary.html">程序包</a></li>
<li class="navBarCell1Rev"></li>
<li><a href="package-tree.html"></a></li>
<li><a href="../../../../../deprecated-list.html">已过时</a></li>
<li><a href="../../../../../index-all.html">索引</a></li>
<li><a href="../../../../../help-doc.html">帮助</a></li>
</ul>
<div class="aboutLanguage"><b>Apache Calcite</b></div>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../org/apache/calcite/sql/type/SqlTypeAssignmentRule.html" title="org.apache.calcite.sql.type中的类"><span class="typeNameLink">上一个类</span></a></li>
<li><a href="../../../../../org/apache/calcite/sql/type/SqlTypeExplicitPrecedenceList.html" title="org.apache.calcite.sql.type中的类"><span class="typeNameLink">下一个类</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../index.html?org/apache/calcite/sql/type/SqlTypeCoercionRule.html" target="_top">框架</a></li>
<li><a href="SqlTypeCoercionRule.html" target="_top">无框架</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../../allclasses-noframe.html">所有类</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>概要:&nbsp;</li>
<li>嵌套&nbsp;|&nbsp;</li>
<li><a href="#field.summary">字段</a>&nbsp;|&nbsp;</li>
<li>构造器&nbsp;|&nbsp;</li>
<li><a href="#method.summary">方法</a></li>
</ul>
<ul class="subNavList">
<li>详细资料:&nbsp;</li>
<li><a href="#field.detail">字段</a>&nbsp;|&nbsp;</li>
<li>构造器&nbsp;|&nbsp;</li>
<li><a href="#method.detail">方法</a></li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.calcite.sql.type</div>
<h2 title="类 SqlTypeCoercionRule" class="title">类 SqlTypeCoercionRule</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="java.lang中的类或接口">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>org.apache.calcite.sql.type.SqlTypeCoercionRule</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>所有已实现的接口:</dt>
<dd><a href="../../../../../org/apache/calcite/sql/type/SqlTypeMappingRule.html" title="org.apache.calcite.sql.type中的接口">SqlTypeMappingRule</a></dd>
</dl>
<hr>
<br>
<pre>public class <span class="typeNameLabel">SqlTypeCoercionRule</span>
extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="java.lang中的类或接口">Object</a>
implements <a href="../../../../../org/apache/calcite/sql/type/SqlTypeMappingRule.html" title="org.apache.calcite.sql.type中的接口">SqlTypeMappingRule</a></pre>
<div class="block">Rules that determine whether a type is castable from another type.
<p>These rules specify the conversion matrix with explicit CAST.
<p>The implicit type coercion matrix should be a sub-set of this explicit one.
We do not define an implicit type coercion matrix, instead we have specific
coercion rules for all kinds of SQL contexts which actually define the "matrix".
<p>To add a new implementation to this class, follow
these steps:
<ol>
<li>Initialize a <a href="../../../../../org/apache/calcite/sql/type/SqlTypeMappingRules.Builder.html" title="org.apache.calcite.sql.type中的类"><code>SqlTypeMappingRules.Builder</code></a> instance
with default mappings of <a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html#INSTANCE"><code>INSTANCE</code></a>.</li>
<li>Modify the mappings with the Builder.</li>
<li>Construct a new <a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html" title="org.apache.calcite.sql.type中的类"><code>SqlTypeCoercionRule</code></a> instance with method
<a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html#instance-java.util.Map-"><code>instance(Map)</code></a>.</li>
<li>Set the <a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html" title="org.apache.calcite.sql.type中的类"><code>SqlTypeCoercionRule</code></a> instance into the
<a href="../../../../../org/apache/calcite/sql/validate/SqlValidator.html" title="org.apache.calcite.sql.validate中的接口"><code>SqlValidator</code></a>.</li>
</ol>
<p>The code snippet below illustrates how to implement a customized instance.
<pre>
// Initialize a Builder instance with the default mappings.
Builder builder = SqlTypeMappingRules.builder();
builder.addAll(SqlTypeCoercionRules.instance().getTypeMapping());
// Do the tweak, for example, if we want to add a rule to allow
// coerce BOOLEAN to TIMESTAMP.
builder.add(SqlTypeName.TIMESTAMP,
builder.copyValues(SqlTypeName.TIMESTAMP)
.add(SqlTypeName.BOOLEAN).build());
// Initialize a SqlTypeCoercionRules with the new builder mappings.
SqlTypeCoercionRules typeCoercionRules = SqlTypeCoercionRules.instance(builder.map);
// Set the SqlTypeCoercionRules instance into the SqlValidator.
SqlValidator validator ...;
validator.setSqlTypeCoercionRules(typeCoercionRules);
</pre></div>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- -->
</a>
<h3>字段概要</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="字段概要表, 列表字段和解释">
<caption><span>字段</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">限定符和类型</th>
<th class="colLast" scope="col">字段和说明</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/ThreadLocal.html?is-external=true" title="java.lang中的类或接口">ThreadLocal</a>&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html" title="org.apache.calcite.sql.type中的类">SqlTypeCoercionRule</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html#THREAD_PROVIDERS">THREAD_PROVIDERS</a></span></code>&nbsp;</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>方法概要</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="方法概要表, 列表方法和解释">
<caption><span id="t0" class="activeTableTab"><span>所有方法</span><span class="tabEnd">&nbsp;</span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">静态方法</a></span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">实例方法</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">具体方法</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">限定符和类型</th>
<th class="colLast" scope="col">方法和说明</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="java.util中的类或接口">Map</a>&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeName.html" title="org.apache.calcite.sql.type中的枚举">SqlTypeName</a>,com.google.common.collect.ImmutableSet&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeName.html" title="org.apache.calcite.sql.type中的枚举">SqlTypeName</a>&gt;&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html#getTypeMapping--">getTypeMapping</a></span>()</code>
<div class="block">Returns the type mappings of this rule instance.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code>static <a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html" title="org.apache.calcite.sql.type中的类">SqlTypeCoercionRule</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html#instance--">instance</a></span>()</code>
<div class="block">Returns an instance.</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code>static <a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html" title="org.apache.calcite.sql.type中的类">SqlTypeCoercionRule</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html#instance-java.util.Map-">instance</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="java.util中的类或接口">Map</a>&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeName.html" title="org.apache.calcite.sql.type中的枚举">SqlTypeName</a>,com.google.common.collect.ImmutableSet&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeName.html" title="org.apache.calcite.sql.type中的枚举">SqlTypeName</a>&gt;&gt;&nbsp;map)</code>
<div class="block">Returns an instance with specified type mappings.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>从类继承的方法&nbsp;java.lang.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="java.lang中的类或接口">Object</a></h3>
<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#clone--" title="java.lang中的类或接口">clone</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="java.lang中的类或接口">equals</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#finalize--" title="java.lang中的类或接口">finalize</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass--" title="java.lang中的类或接口">getClass</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="java.lang中的类或接口">hashCode</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify--" title="java.lang中的类或接口">notify</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="java.lang中的类或接口">notifyAll</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#toString--" title="java.lang中的类或接口">toString</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait--" title="java.lang中的类或接口">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="java.lang中的类或接口">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="java.lang中的类或接口">wait</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.apache.calcite.sql.type.SqlTypeMappingRule">
<!-- -->
</a>
<h3>从接口继承的方法&nbsp;org.apache.calcite.sql.type.<a href="../../../../../org/apache/calcite/sql/type/SqlTypeMappingRule.html" title="org.apache.calcite.sql.type中的接口">SqlTypeMappingRule</a></h3>
<code><a href="../../../../../org/apache/calcite/sql/type/SqlTypeMappingRule.html#canApplyFrom-org.apache.calcite.sql.type.SqlTypeName-org.apache.calcite.sql.type.SqlTypeName-">canApplyFrom</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- -->
</a>
<h3>字段详细资料</h3>
<a name="THREAD_PROVIDERS">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>THREAD_PROVIDERS</h4>
<pre>public static final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/ThreadLocal.html?is-external=true" title="java.lang中的类或接口">ThreadLocal</a>&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html" title="org.apache.calcite.sql.type中的类">SqlTypeCoercionRule</a>&gt; THREAD_PROVIDERS</pre>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>方法详细资料</h3>
<a name="instance--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>instance</h4>
<pre>public static&nbsp;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html" title="org.apache.calcite.sql.type中的类">SqlTypeCoercionRule</a>&nbsp;instance()</pre>
<div class="block">Returns an instance.</div>
</li>
</ul>
<a name="instance-java.util.Map-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>instance</h4>
<pre>public static&nbsp;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeCoercionRule.html" title="org.apache.calcite.sql.type中的类">SqlTypeCoercionRule</a>&nbsp;instance(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="java.util中的类或接口">Map</a>&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeName.html" title="org.apache.calcite.sql.type中的枚举">SqlTypeName</a>,com.google.common.collect.ImmutableSet&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeName.html" title="org.apache.calcite.sql.type中的枚举">SqlTypeName</a>&gt;&gt;&nbsp;map)</pre>
<div class="block">Returns an instance with specified type mappings.</div>
</li>
</ul>
<a name="getTypeMapping--">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>getTypeMapping</h4>
<pre>public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="java.util中的类或接口">Map</a>&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeName.html" title="org.apache.calcite.sql.type中的枚举">SqlTypeName</a>,com.google.common.collect.ImmutableSet&lt;<a href="../../../../../org/apache/calcite/sql/type/SqlTypeName.html" title="org.apache.calcite.sql.type中的枚举">SqlTypeName</a>&gt;&gt;&nbsp;getTypeMapping()</pre>
<div class="block"><span class="descfrmTypeLabel">从接口复制的说明:&nbsp;<code><a href="../../../../../org/apache/calcite/sql/type/SqlTypeMappingRule.html#getTypeMapping--">SqlTypeMappingRule</a></code></span></div>
<div class="block">Returns the type mappings of this rule instance.
<p>The mappings should be immutable.</div>
<dl>
<dt><span class="overrideSpecifyLabel">指定者:</span></dt>
<dd><code><a href="../../../../../org/apache/calcite/sql/type/SqlTypeMappingRule.html#getTypeMapping--">getTypeMapping</a></code>&nbsp;在接口中&nbsp;<code><a href="../../../../../org/apache/calcite/sql/type/SqlTypeMappingRule.html" title="org.apache.calcite.sql.type中的接口">SqlTypeMappingRule</a></code></dd>
</dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="跳过导航链接">跳过导航链接</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="导航">
<li><a href="../../../../../overview-summary.html">概览</a></li>
<li><a href="package-summary.html">程序包</a></li>
<li class="navBarCell1Rev"></li>
<li><a href="package-tree.html"></a></li>
<li><a href="../../../../../deprecated-list.html">已过时</a></li>
<li><a href="../../../../../index-all.html">索引</a></li>
<li><a href="../../../../../help-doc.html">帮助</a></li>
</ul>
<div class="aboutLanguage"><b>Apache Calcite</b></div>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../org/apache/calcite/sql/type/SqlTypeAssignmentRule.html" title="org.apache.calcite.sql.type中的类"><span class="typeNameLink">上一个类</span></a></li>
<li><a href="../../../../../org/apache/calcite/sql/type/SqlTypeExplicitPrecedenceList.html" title="org.apache.calcite.sql.type中的类"><span class="typeNameLink">下一个类</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../index.html?org/apache/calcite/sql/type/SqlTypeCoercionRule.html" target="_top">框架</a></li>
<li><a href="SqlTypeCoercionRule.html" target="_top">无框架</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../../allclasses-noframe.html">所有类</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>概要:&nbsp;</li>
<li>嵌套&nbsp;|&nbsp;</li>
<li><a href="#field.summary">字段</a>&nbsp;|&nbsp;</li>
<li>构造器&nbsp;|&nbsp;</li>
<li><a href="#method.summary">方法</a></li>
</ul>
<ul class="subNavList">
<li>详细资料:&nbsp;</li>
<li><a href="#field.detail">字段</a>&nbsp;|&nbsp;</li>
<li>构造器&nbsp;|&nbsp;</li>
<li><a href="#method.detail">方法</a></li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &copy; 2012-2020 Apache Software Foundation. All Rights Reserved.</small></p>
</body>
</html>