Class AbstractPlayerStore

java.lang.Object

server.maps.MapleMapObject

server.shops.AbstractPlayerStore

All Implemented Interfaces:

IMaplePlayerShop

Direct Known Subclasses:

HiredMerchant, MapleMiniGame, MaplePlayerShop

public abstract class AbstractPlayerStore
extends MapleMapObject
implements IMaplePlayerShop

玩家自設商店（個人商店、精靈商人、五目棋/翻牌）的抽象基底類別。

繼承自 MapleMapObject，並實作 IMaplePlayerShop； 提供所有商店類型共用的核心狀態與行為：

• 以 WeakReference 陣列管理最多 N 個訪客槽（避免強參照洩漏）。
• 以 AtomicInteger 安全維護累積楓幣（meso）。
• MaplePlayerShopItem 清單儲存上架道具；BoughtItem 記錄成交記錄。
• saveItems() 將精靈商人剩餘道具持久化至 hiredmerch 資料庫表， 透過 ItemLoader.HIRED_MERCHANT 序列化。
• broadcastToVisitors 系列方法將封包廣播至所有在場訪客（可排除特定槽位）。

具體子類別有 MaplePlayerShop、HiredMerchant 與 MapleMiniGame， 由 PlayerInteractionHandler 依 opcode 分派建立與操作。

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	AbstractPlayerStore.BoughtItem

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	available
protected List<AbstractPlayerStore.BoughtItem>	bought
protected int	channel
protected WeakReference<MapleCharacter>[]	chrs
protected String	des
protected int	itemId
protected List<MaplePlayerShopItem>	items
protected int	map
protected AtomicInteger	meso
protected boolean	open
protected int	owneraccount
protected int	ownerId
protected String	ownerName
protected String	pass
protected List<String>	visitors

Fields inherited from interface IMaplePlayerShop

HIRED_MERCHANT, MATCH_CARD, OMOK, PLAYER_SHOP

Constructor Summary

Constructors

Constructor	Description
AbstractPlayerStore(MapleCharacter owner, int itemId, String desc, String pass, int slots)

Method Summary

Modifier and Type	Method	Description
void	addItem(MaplePlayerShopItem item)
void	addVisitor(MapleCharacter visitor)
void	broadcastToVisitors(byte[] packet)
void	broadcastToVisitors(byte[] packet, boolean owner)
void	broadcastToVisitors(byte[] packet, int exception)
List<AbstractPlayerStore.BoughtItem>	getBoughtItems()
String	getDescription()
byte	getFreeSlot()
int	getGameType()
int	getItemId()
List<MaplePlayerShopItem>	getItems()
MapleMap	getMap()
int	getMaxSize()
MapleCharacter	getMCOwner()
MapleCharacter	getMCOwnerChannel()
MapleCharacter	getMCOwnerWorld()
int	getMeso()
int	getOwnerAccId()
int	getOwnerId()
String	getOwnerName()
String	getPassword()
int	getSize()
MapleMapObjectType	getType()
MapleCharacter	getVisitor(int num)
List<Pair<Byte, MapleCharacter>>	getVisitors()
byte	getVisitorSlot(MapleCharacter visitor)
boolean	isAvailable()
boolean	isOpen()
boolean	isOwner(MapleCharacter chr)
void	removeAllVisitors(int error, int type)
void	removeFromSlot(int slot)
boolean	removeItem(int item)
void	removeVisitor(MapleCharacter visitor)
boolean	saveItems()
void	sendDestroyData(MapleClient client)
void	sendSpawnData(MapleClient client)
void	setAvailable(boolean b)
void	setMeso(int meso)
void	setOpen(boolean open)
void	update()

Methods inherited from class MapleMapObject

getObjectId, getPosition, getRange, getTruePosition, setObjectId, setPosition

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface IMaplePlayerShop

buy, closeShop, getShopType

Field Details

open

protected boolean open

available

protected boolean available

ownerName

protected String ownerName

des

protected String des

pass

protected String pass

ownerId

protected int ownerId

owneraccount

protected int owneraccount

itemId

protected int itemId

channel

protected int channel

map

protected int map

meso

protected AtomicInteger meso

chrs

protected WeakReference<MapleCharacter>[] chrs

visitors

protected List<String> visitors

bought

protected List<AbstractPlayerStore.BoughtItem> bought

items

protected List<MaplePlayerShopItem> items

Constructor Details

AbstractPlayerStore

public AbstractPlayerStore(MapleCharacter owner,
 int itemId,
 String desc,
 String pass,
 int slots)

Method Details

getMaxSize

public int getMaxSize()

Specified by:

getMaxSize in interface IMaplePlayerShop

getSize

public int getSize()

Specified by:

getSize in interface IMaplePlayerShop

broadcastToVisitors

public void broadcastToVisitors(byte[] packet)

Specified by:

broadcastToVisitors in interface IMaplePlayerShop

broadcastToVisitors

public void broadcastToVisitors(byte[] packet,
 boolean owner)

broadcastToVisitors

public void broadcastToVisitors(byte[] packet,
 int exception)

getMeso

public int getMeso()

Specified by:

getMeso in interface IMaplePlayerShop

setMeso

public void setMeso(int meso)

Specified by:

setMeso in interface IMaplePlayerShop

setOpen

public void setOpen(boolean open)

Specified by:

setOpen in interface IMaplePlayerShop

isOpen

public boolean isOpen()

Specified by:

isOpen in interface IMaplePlayerShop

saveItems

public boolean saveItems()

getVisitor

public MapleCharacter getVisitor(int num)

update

public void update()

Specified by:

update in interface IMaplePlayerShop

addVisitor

public void addVisitor(MapleCharacter visitor)

Specified by:

addVisitor in interface IMaplePlayerShop

removeVisitor

public void removeVisitor(MapleCharacter visitor)

Specified by:

removeVisitor in interface IMaplePlayerShop

getVisitorSlot

public byte getVisitorSlot(MapleCharacter visitor)

Specified by:

getVisitorSlot in interface IMaplePlayerShop

removeAllVisitors

public void removeAllVisitors(int error,
 int type)

Specified by:

removeAllVisitors in interface IMaplePlayerShop

getOwnerName

public String getOwnerName()

Specified by:

getOwnerName in interface IMaplePlayerShop

getOwnerId

public int getOwnerId()

Specified by:

getOwnerId in interface IMaplePlayerShop

getOwnerAccId

public int getOwnerAccId()

Specified by:

getOwnerAccId in interface IMaplePlayerShop

getDescription

public String getDescription()

Specified by:

getDescription in interface IMaplePlayerShop

getVisitors

public List<Pair<Byte, MapleCharacter>> getVisitors()

Specified by:

getVisitors in interface IMaplePlayerShop

getItems

public List<MaplePlayerShopItem> getItems()

Specified by:

getItems in interface IMaplePlayerShop

addItem

public void addItem(MaplePlayerShopItem item)

Specified by:

addItem in interface IMaplePlayerShop

removeItem

public boolean removeItem(int item)

Specified by:

removeItem in interface IMaplePlayerShop

removeFromSlot

public void removeFromSlot(int slot)

Specified by:

removeFromSlot in interface IMaplePlayerShop

getFreeSlot

public byte getFreeSlot()

Specified by:

getFreeSlot in interface IMaplePlayerShop

getItemId

public int getItemId()

Specified by:

getItemId in interface IMaplePlayerShop

isOwner

public boolean isOwner(MapleCharacter chr)

Specified by:

isOwner in interface IMaplePlayerShop

getPassword

public String getPassword()

Specified by:

getPassword in interface IMaplePlayerShop

sendDestroyData

public void sendDestroyData(MapleClient client)

Specified by:

sendDestroyData in class MapleMapObject

sendSpawnData

public void sendSpawnData(MapleClient client)

Specified by:

sendSpawnData in class MapleMapObject

getType

public MapleMapObjectType getType()

Specified by:

getType in class MapleMapObject

getMCOwnerWorld

public MapleCharacter getMCOwnerWorld()

getMCOwnerChannel

public MapleCharacter getMCOwnerChannel()

getMCOwner

public MapleCharacter getMCOwner()

getMap

public MapleMap getMap()

getGameType

public int getGameType()

Specified by:

getGameType in interface IMaplePlayerShop

isAvailable

public boolean isAvailable()

Specified by:

isAvailable in interface IMaplePlayerShop

setAvailable

public void setAvailable(boolean b)

Specified by:

setAvailable in interface IMaplePlayerShop

getBoughtItems

public List<AbstractPlayerStore.BoughtItem> getBoughtItems()

Specified by:

getBoughtItems in interface IMaplePlayerShop