380 lines
17 KiB
HTML
380 lines
17 KiB
HTML
<!DOCTYPE HTML>
|
|
<!-- NewPage -->
|
|
<html lang="fr">
|
|
<head>
|
|
<!-- Generated by javadoc (15) on Fri May 07 15:56:25 CEST 2021 -->
|
|
<title>Player</title>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf8">
|
|
<meta name="dc.created" content="2021-05-07">
|
|
<meta name="description" content="declaration: package: battleship.model.player, interface: Player">
|
|
<meta name="generator" content="javadoc/ClassWriterImpl">
|
|
<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
|
|
<link rel="stylesheet" type="text/css" href="../../../script-dir/jquery-ui.min.css" title="Style">
|
|
<link rel="stylesheet" type="text/css" href="../../../jquery-ui.overrides.css" title="Style">
|
|
<script type="text/javascript" src="../../../script.js"></script>
|
|
<script type="text/javascript" src="../../../script-dir/jquery-3.5.1.min.js"></script>
|
|
<script type="text/javascript" src="../../../script-dir/jquery-ui.min.js"></script>
|
|
</head>
|
|
<body class="class-declaration-page">
|
|
<script type="text/javascript">var data = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6};
|
|
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"]};
|
|
var altColor = "alt-color";
|
|
var rowColor = "row-color";
|
|
var tableTab = "table-tab";
|
|
var activeTableTab = "active-table-tab";
|
|
var pathtoroot = "../../../";
|
|
loadScripts(document, 'script');</script>
|
|
<noscript>
|
|
<div>JavaScript is disabled on your browser.</div>
|
|
</noscript>
|
|
<div class="flex-box">
|
|
<header role="banner" class="flex-header">
|
|
<nav role="navigation">
|
|
<!-- ========= START OF TOP NAVBAR ======= -->
|
|
<div class="top-nav" id="navbar.top">
|
|
<div class="skip-nav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
|
|
<ul id="navbar.top.firstrow" class="nav-list" title="Navigation">
|
|
<li><a href="../../../index.html">Overview</a></li>
|
|
<li><a href="package-summary.html">Package</a></li>
|
|
<li class="nav-bar-cell1-rev">Class</li>
|
|
<li><a href="package-tree.html">Tree</a></li>
|
|
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
|
|
<li><a href="../../../index-all.html">Index</a></li>
|
|
<li><a href="../../../help-doc.html">Help</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="sub-nav">
|
|
<div>
|
|
<ul class="sub-nav-list">
|
|
<li>Summary: </li>
|
|
<li>Nested | </li>
|
|
<li><a href="#field.summary">Field</a> | </li>
|
|
<li>Constr | </li>
|
|
<li><a href="#method.summary">Method</a></li>
|
|
</ul>
|
|
<ul class="sub-nav-list">
|
|
<li>Detail: </li>
|
|
<li><a href="#field.detail">Field</a> | </li>
|
|
<li>Constr | </li>
|
|
<li><a href="#method.detail">Method</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="nav-list-search"><label for="search">SEARCH:</label>
|
|
<input type="text" id="search" value="search" disabled="disabled">
|
|
<input type="reset" id="reset" value="reset" disabled="disabled">
|
|
</div>
|
|
</div>
|
|
<!-- ========= END OF TOP NAVBAR ========= -->
|
|
<span class="skip-nav" id="skip.navbar.top">
|
|
<!-- -->
|
|
</span></nav>
|
|
</header>
|
|
<div class="flex-content">
|
|
<main role="main">
|
|
<!-- ======== START OF CLASS DATA ======== -->
|
|
<div class="header">
|
|
<div class="sub-title"><span class="package-label-in-type">Package</span> <a href="package-summary.html">battleship.model.player</a></div>
|
|
<h1 title="Interface Player" class="title">Interface Player</h1>
|
|
</div>
|
|
<section class="description">
|
|
<dl class="notes">
|
|
<dt>All Known Implementing Classes:</dt>
|
|
<dd><code><a href="AbstractPlayer.html" title="class in battleship.model.player">AbstractPlayer</a></code>, <code><a href="Computer.html" title="class in battleship.model.player">Computer</a></code>, <code><a href="Human.html" title="class in battleship.model.player">Human</a></code>, <code><a href="Random.html" title="class in battleship.model.player">Random</a></code></dd>
|
|
</dl>
|
|
<hr>
|
|
<pre>public interface <span class="type-name-label">Player</span></pre>
|
|
<div class="block"><p>Player interface, used as an API.</p>
|
|
<p>This model (interface -> abstract class(es) -> concrete classes) prevent hard code.</p>
|
|
<p>This is the only object which interact with other object<br>
|
|
Allows an outside person from the project to easily change the code or to add a view easily without modifying
|
|
existing classes</p></div>
|
|
<dl class="notes">
|
|
<dt>See Also:</dt>
|
|
<dd><a href="AbstractPlayer.html" title="class in battleship.model.player"><code>AbstractPlayer</code></a>,
|
|
<a href="Computer.html" title="class in battleship.model.player"><code>Computer</code></a>,
|
|
<a href="Human.html" title="class in battleship.model.player"><code>Human</code></a>,
|
|
<a href="Random.html" title="class in battleship.model.player"><code>Random</code></a></dd>
|
|
</dl>
|
|
</section>
|
|
<section class="summary">
|
|
<ul class="summary-list">
|
|
<!-- =========== FIELD SUMMARY =========== -->
|
|
<li>
|
|
<section class="field-summary" id="field.summary">
|
|
<h2>Field Summary</h2>
|
|
<div class="member-summary">
|
|
<table class="summary-table">
|
|
<caption><span>Fields</span></caption>
|
|
<thead>
|
|
<tr>
|
|
<th class="col-first" scope="col">Modifier and Type</th>
|
|
<th class="col-second" scope="col">Field</th>
|
|
<th class="col-last" scope="col">Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr class="alt-color">
|
|
<td class="col-first"><code>static int[]</code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#shipSize">shipSize</a></span></code></th>
|
|
<td class="col-last"> </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</section>
|
|
</li>
|
|
<!-- ========== METHOD SUMMARY =========== -->
|
|
<li>
|
|
<section class="method-summary" id="method.summary">
|
|
<h2>Method Summary</h2>
|
|
<div class="member-summary" id="method-summary-table">
|
|
<div class="table-tabs" role="tablist" aria-orientation="horizontal"><button role="tab" aria-selected="true" aria-controls="method-summary-table.tabpanel" tabindex="0" onkeydown="switchTab(event)" id="t0" class="active-table-tab">All Methods</button><button role="tab" aria-selected="false" aria-controls="method-summary-table.tabpanel" tabindex="-1" onkeydown="switchTab(event)" id="t2" class="table-tab" onclick="show(2);">Instance Methods</button><button role="tab" aria-selected="false" aria-controls="method-summary-table.tabpanel" tabindex="-1" onkeydown="switchTab(event)" id="t3" class="table-tab" onclick="show(4);">Abstract Methods</button></div>
|
|
<div id="method-summary-table.tabpanel" role="tabpanel">
|
|
<table class="summary-table" aria-labelledby="t0">
|
|
<thead>
|
|
<tr>
|
|
<th class="col-first" scope="col">Modifier and Type</th>
|
|
<th class="col-second" scope="col">Method</th>
|
|
<th class="col-last" scope="col">Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr class="alt-color" id="i0">
|
|
<td class="col-first"><code>void</code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#addMove(battleship.utils.Triplet)">addMove</a></span>​(<a href="../../utils/Triplet.html" title="class in battleship.utils">Triplet</a><java.lang.Integer,​java.lang.Integer,​java.lang.Boolean> move)</code></th>
|
|
<td class="col-last">
|
|
<div class="block">Adds coordinates of the <code>move</code> in the <a href="AbstractPlayer.html#moves"><code>AbstractPlayer.moves</code></a> list</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="row-color" id="i1">
|
|
<td class="col-first"><code>boolean</code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#areValid(int,int)">areValid</a></span>​(int x,
|
|
int y)</code></th>
|
|
<td class="col-last">
|
|
<div class="block">check if coordinates from <a href="../../view/View.html#chooseMove(battleship.model.player.Player)"><code>View.chooseMove(Player)</code></a>are in valids position</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="alt-color" id="i2">
|
|
<td class="col-first"><code><a href="../../utils/Pair.html" title="class in battleship.utils">Pair</a><java.lang.Integer,​java.lang.Integer></code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#chooseMove()">chooseMove</a></span>()</code></th>
|
|
<td class="col-last">
|
|
<div class="block">Used by computer only</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="row-color" id="i3">
|
|
<td class="col-first"><code>int</code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#getId()">getId</a></span>()</code></th>
|
|
<td class="col-last"> </td>
|
|
</tr>
|
|
<tr class="alt-color" id="i4">
|
|
<td class="col-first"><code>java.util.ArrayList<<a href="../../utils/Triplet.html" title="class in battleship.utils">Triplet</a><java.lang.Integer,​java.lang.Integer,​java.lang.Boolean>></code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#getMoves()">getMoves</a></span>()</code></th>
|
|
<td class="col-last"> </td>
|
|
</tr>
|
|
<tr class="row-color" id="i5">
|
|
<td class="col-first"><code>java.util.ArrayList<<a href="../Ship.html" title="class in battleship.model">Ship</a>></code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#getShips()">getShips</a></span>()</code></th>
|
|
<td class="col-last"> </td>
|
|
</tr>
|
|
<tr class="alt-color" id="i6">
|
|
<td class="col-first"><code>void</code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#placeShips()">placeShips</a></span>()</code></th>
|
|
<td class="col-last">
|
|
<div class="block">Used by <a href="Computer.html" title="class in battleship.model.player"><code>Computer</code></a> instances to place ships</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="row-color" id="i7">
|
|
<td class="col-first"><code>void</code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#setId(int)">setId</a></span>​(int i)</code></th>
|
|
<td class="col-last"> </td>
|
|
</tr>
|
|
<tr class="alt-color" id="i8">
|
|
<td class="col-first"><code>boolean</code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#setShips(battleship.model.Ship)">setShips</a></span>​(<a href="../Ship.html" title="class in battleship.model">Ship</a> ship)</code></th>
|
|
<td class="col-last">
|
|
<div class="block">check if ship position and direction are valides and does not overlap on other vessels
|
|
add the ship to player <a href="AbstractPlayer.html#ships"><code>AbstractPlayer.ships</code></a> list and return <code>true</code> if valid
|
|
<code>false</code> otherwise</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="row-color" id="i9">
|
|
<td class="col-first"><code>java.util.ArrayList<<a href="../../utils/Pair.html" title="class in battleship.utils">Pair</a><java.lang.Integer,​java.lang.Integer>></code></td>
|
|
<th class="col-second" scope="row"><code><span class="member-name-link"><a href="#validMoves()">validMoves</a></span>()</code></th>
|
|
<td class="col-last">
|
|
<div class="block">give a list of the player possible moves, used in <a href="#chooseMove()"><code>chooseMove()</code></a></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
</li>
|
|
</ul>
|
|
</section>
|
|
<section class="details">
|
|
<ul class="details-list">
|
|
<!-- ============ FIELD DETAIL =========== -->
|
|
<li>
|
|
<section class="field-details" id="field.detail">
|
|
<h2>Field Details</h2>
|
|
<ul class="member-list">
|
|
<li>
|
|
<section class="detail" id="shipSize">
|
|
<h3>shipSize</h3>
|
|
<div class="member-signature"><span class="modifiers">static final</span> <span class="return-type">int[]</span> <span class="member-name">shipSize</span></div>
|
|
</section>
|
|
</li>
|
|
</ul>
|
|
</section>
|
|
</li>
|
|
<!-- ============ METHOD DETAIL ========== -->
|
|
<li>
|
|
<section class="method-details" id="method.detail">
|
|
<h2>Method Details</h2>
|
|
<ul class="member-list">
|
|
<li>
|
|
<section class="detail" id="chooseMove()">
|
|
<h3>chooseMove</h3>
|
|
<div class="member-signature"><span class="return-type"><a href="../../utils/Pair.html" title="class in battleship.utils">Pair</a><java.lang.Integer,​java.lang.Integer></span> <span class="member-name">chooseMove</span>()</div>
|
|
<div class="block">Used by computer only</div>
|
|
<dl class="notes">
|
|
<dt>Returns:</dt>
|
|
<dd>coords in its opponent grid to play a move</dd>
|
|
<dt>See Also:</dt>
|
|
<dd><a href="Random.html#chooseMove()"><code>Random.chooseMove()</code></a></dd>
|
|
</dl>
|
|
</section>
|
|
</li>
|
|
<li>
|
|
<section class="detail" id="setShips(battleship.model.Ship)">
|
|
<h3>setShips</h3>
|
|
<div class="member-signature"><span class="return-type">boolean</span> <span class="member-name">setShips</span>​(<span class="parameters"><a href="../Ship.html" title="class in battleship.model">Ship</a> ship)</span></div>
|
|
<div class="block">check if ship position and direction are valides and does not overlap on other vessels
|
|
add the ship to player <a href="AbstractPlayer.html#ships"><code>AbstractPlayer.ships</code></a> list and return <code>true</code> if valid
|
|
<code>false</code> otherwise</div>
|
|
<dl class="notes">
|
|
<dt>Parameters:</dt>
|
|
<dd><code>ship</code> - the ship instance we check</dd>
|
|
<dt>Returns:</dt>
|
|
<dd><code>true</code> if ship data are valids, <code>false</code> otherwise</dd>
|
|
</dl>
|
|
</section>
|
|
</li>
|
|
<li>
|
|
<section class="detail" id="getId()">
|
|
<h3>getId</h3>
|
|
<div class="member-signature"><span class="return-type">int</span> <span class="member-name">getId</span>()</div>
|
|
</section>
|
|
</li>
|
|
<li>
|
|
<section class="detail" id="addMove(battleship.utils.Triplet)">
|
|
<h3>addMove</h3>
|
|
<div class="member-signature"><span class="return-type">void</span> <span class="member-name">addMove</span>​(<span class="parameters"><a href="../../utils/Triplet.html" title="class in battleship.utils">Triplet</a><java.lang.Integer,​java.lang.Integer,​java.lang.Boolean> move)</span></div>
|
|
<div class="block">Adds coordinates of the <code>move</code> in the <a href="AbstractPlayer.html#moves"><code>AbstractPlayer.moves</code></a> list</div>
|
|
<dl class="notes">
|
|
<dt>Parameters:</dt>
|
|
<dd><code>move</code> - the move chosen by the player</dd>
|
|
</dl>
|
|
</section>
|
|
</li>
|
|
<li>
|
|
<section class="detail" id="setId(int)">
|
|
<h3>setId</h3>
|
|
<div class="member-signature"><span class="return-type">void</span> <span class="member-name">setId</span>​(<span class="parameters">int i)</span></div>
|
|
</section>
|
|
</li>
|
|
<li>
|
|
<section class="detail" id="validMoves()">
|
|
<h3>validMoves</h3>
|
|
<div class="member-signature"><span class="return-type">java.util.ArrayList<<a href="../../utils/Pair.html" title="class in battleship.utils">Pair</a><java.lang.Integer,​java.lang.Integer>></span> <span class="member-name">validMoves</span>()</div>
|
|
<div class="block">give a list of the player possible moves, used in <a href="#chooseMove()"><code>chooseMove()</code></a></div>
|
|
<dl class="notes">
|
|
<dt>Returns:</dt>
|
|
<dd>a list of playable move</dd>
|
|
</dl>
|
|
</section>
|
|
</li>
|
|
<li>
|
|
<section class="detail" id="placeShips()">
|
|
<h3>placeShips</h3>
|
|
<div class="member-signature"><span class="return-type">void</span> <span class="member-name">placeShips</span>()</div>
|
|
<div class="block">Used by <a href="Computer.html" title="class in battleship.model.player"><code>Computer</code></a> instances to place ships</div>
|
|
</section>
|
|
</li>
|
|
<li>
|
|
<section class="detail" id="areValid(int,int)">
|
|
<h3>areValid</h3>
|
|
<div class="member-signature"><span class="return-type">boolean</span> <span class="member-name">areValid</span>​(<span class="parameters">int x,
|
|
int y)</span></div>
|
|
<div class="block">check if coordinates from <a href="../../view/View.html#chooseMove(battleship.model.player.Player)"><code>View.chooseMove(Player)</code></a>are in valids position</div>
|
|
<dl class="notes">
|
|
<dt>Parameters:</dt>
|
|
<dd><code>x</code> - the x-axis of the coordinates</dd>
|
|
<dd><code>y</code> - the y-axis of the coordinates</dd>
|
|
<dt>Returns:</dt>
|
|
<dd><code>true</code> if valid, <code>false</code> otherwise</dd>
|
|
</dl>
|
|
</section>
|
|
</li>
|
|
<li>
|
|
<section class="detail" id="getShips()">
|
|
<h3>getShips</h3>
|
|
<div class="member-signature"><span class="return-type">java.util.ArrayList<<a href="../Ship.html" title="class in battleship.model">Ship</a>></span> <span class="member-name">getShips</span>()</div>
|
|
</section>
|
|
</li>
|
|
<li>
|
|
<section class="detail" id="getMoves()">
|
|
<h3>getMoves</h3>
|
|
<div class="member-signature"><span class="return-type">java.util.ArrayList<<a href="../../utils/Triplet.html" title="class in battleship.utils">Triplet</a><java.lang.Integer,​java.lang.Integer,​java.lang.Boolean>></span> <span class="member-name">getMoves</span>()</div>
|
|
</section>
|
|
</li>
|
|
</ul>
|
|
</section>
|
|
</li>
|
|
</ul>
|
|
</section>
|
|
<!-- ========= END OF CLASS DATA ========= -->
|
|
</main>
|
|
<footer role="contentinfo">
|
|
<nav role="navigation">
|
|
<!-- ======= START OF BOTTOM NAVBAR ====== -->
|
|
<div class="bottom-nav" id="navbar.bottom">
|
|
<div class="skip-nav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
|
|
<ul id="navbar.bottom.firstrow" class="nav-list" title="Navigation">
|
|
<li><a href="../../../index.html">Overview</a></li>
|
|
<li><a href="package-summary.html">Package</a></li>
|
|
<li class="nav-bar-cell1-rev">Class</li>
|
|
<li><a href="package-tree.html">Tree</a></li>
|
|
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
|
|
<li><a href="../../../index-all.html">Index</a></li>
|
|
<li><a href="../../../help-doc.html">Help</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="sub-nav">
|
|
<div>
|
|
<ul class="sub-nav-list">
|
|
<li>Summary: </li>
|
|
<li>Nested | </li>
|
|
<li><a href="#field.summary">Field</a> | </li>
|
|
<li>Constr | </li>
|
|
<li><a href="#method.summary">Method</a></li>
|
|
</ul>
|
|
<ul class="sub-nav-list">
|
|
<li>Detail: </li>
|
|
<li><a href="#field.detail">Field</a> | </li>
|
|
<li>Constr | </li>
|
|
<li><a href="#method.detail">Method</a></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<!-- ======== END OF BOTTOM NAVBAR ======= -->
|
|
<span class="skip-nav" id="skip.navbar.bottom">
|
|
<!-- -->
|
|
</span></nav>
|
|
</footer>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|