version1 卡码笔记
This commit is contained in:
Tong
parent
9431f1557d
commit
b440907fa4
28
.gitignore
vendored
28
.gitignore
vendored
@ -1,28 +0,0 @@
|
|||||||
# Logs
|
|
||||||
logs
|
|
||||||
*.log
|
|
||||||
npm-debug.log*
|
|
||||||
yarn-debug.log*
|
|
||||||
yarn-error.log*
|
|
||||||
pnpm-debug.log*
|
|
||||||
lerna-debug.log*
|
|
||||||
|
|
||||||
node_modules
|
|
||||||
dist
|
|
||||||
dist-ssr
|
|
||||||
*.local
|
|
||||||
|
|
||||||
# Editor directories and files
|
|
||||||
.vscode/*
|
|
||||||
!.vscode/extensions.json
|
|
||||||
.idea
|
|
||||||
.DS_Store
|
|
||||||
*.suo
|
|
||||||
*.ntvs*
|
|
||||||
*.njsproj
|
|
||||||
*.sln
|
|
||||||
*.sw?
|
|
||||||
|
|
||||||
# 其它文件
|
|
||||||
|
|
||||||
stats.html
|
|
||||||
674
LICENSE
674
LICENSE
@ -1,674 +0,0 @@
|
|||||||
GNU GENERAL PUBLIC LICENSE
|
|
||||||
Version 3, 29 June 2007
|
|
||||||
|
|
||||||
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
|
||||||
Everyone is permitted to copy and distribute verbatim copies
|
|
||||||
of this license document, but changing it is not allowed.
|
|
||||||
|
|
||||||
Preamble
|
|
||||||
|
|
||||||
The GNU General Public License is a free, copyleft license for
|
|
||||||
software and other kinds of works.
|
|
||||||
|
|
||||||
The licenses for most software and other practical works are designed
|
|
||||||
to take away your freedom to share and change the works. By contrast,
|
|
||||||
the GNU General Public License is intended to guarantee your freedom to
|
|
||||||
share and change all versions of a program--to make sure it remains free
|
|
||||||
software for all its users. We, the Free Software Foundation, use the
|
|
||||||
GNU General Public License for most of our software; it applies also to
|
|
||||||
any other work released this way by its authors. You can apply it to
|
|
||||||
your programs, too.
|
|
||||||
|
|
||||||
When we speak of free software, we are referring to freedom, not
|
|
||||||
price. Our General Public Licenses are designed to make sure that you
|
|
||||||
have the freedom to distribute copies of free software (and charge for
|
|
||||||
them if you wish), that you receive source code or can get it if you
|
|
||||||
want it, that you can change the software or use pieces of it in new
|
|
||||||
free programs, and that you know you can do these things.
|
|
||||||
|
|
||||||
To protect your rights, we need to prevent others from denying you
|
|
||||||
these rights or asking you to surrender the rights. Therefore, you have
|
|
||||||
certain responsibilities if you distribute copies of the software, or if
|
|
||||||
you modify it: responsibilities to respect the freedom of others.
|
|
||||||
|
|
||||||
For example, if you distribute copies of such a program, whether
|
|
||||||
gratis or for a fee, you must pass on to the recipients the same
|
|
||||||
freedoms that you received. You must make sure that they, too, receive
|
|
||||||
or can get the source code. And you must show them these terms so they
|
|
||||||
know their rights.
|
|
||||||
|
|
||||||
Developers that use the GNU GPL protect your rights with two steps:
|
|
||||||
(1) assert copyright on the software, and (2) offer you this License
|
|
||||||
giving you legal permission to copy, distribute and/or modify it.
|
|
||||||
|
|
||||||
For the developers' and authors' protection, the GPL clearly explains
|
|
||||||
that there is no warranty for this free software. For both users' and
|
|
||||||
authors' sake, the GPL requires that modified versions be marked as
|
|
||||||
changed, so that their problems will not be attributed erroneously to
|
|
||||||
authors of previous versions.
|
|
||||||
|
|
||||||
Some devices are designed to deny users access to install or run
|
|
||||||
modified versions of the software inside them, although the manufacturer
|
|
||||||
can do so. This is fundamentally incompatible with the aim of
|
|
||||||
protecting users' freedom to change the software. The systematic
|
|
||||||
pattern of such abuse occurs in the area of products for individuals to
|
|
||||||
use, which is precisely where it is most unacceptable. Therefore, we
|
|
||||||
have designed this version of the GPL to prohibit the practice for those
|
|
||||||
products. If such problems arise substantially in other domains, we
|
|
||||||
stand ready to extend this provision to those domains in future versions
|
|
||||||
of the GPL, as needed to protect the freedom of users.
|
|
||||||
|
|
||||||
Finally, every program is threatened constantly by software patents.
|
|
||||||
States should not allow patents to restrict development and use of
|
|
||||||
software on general-purpose computers, but in those that do, we wish to
|
|
||||||
avoid the special danger that patents applied to a free program could
|
|
||||||
make it effectively proprietary. To prevent this, the GPL assures that
|
|
||||||
patents cannot be used to render the program non-free.
|
|
||||||
|
|
||||||
The precise terms and conditions for copying, distribution and
|
|
||||||
modification follow.
|
|
||||||
|
|
||||||
TERMS AND CONDITIONS
|
|
||||||
|
|
||||||
0. Definitions.
|
|
||||||
|
|
||||||
"This License" refers to version 3 of the GNU General Public License.
|
|
||||||
|
|
||||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
|
||||||
works, such as semiconductor masks.
|
|
||||||
|
|
||||||
"The Program" refers to any copyrightable work licensed under this
|
|
||||||
License. Each licensee is addressed as "you". "Licensees" and
|
|
||||||
"recipients" may be individuals or organizations.
|
|
||||||
|
|
||||||
To "modify" a work means to copy from or adapt all or part of the work
|
|
||||||
in a fashion requiring copyright permission, other than the making of an
|
|
||||||
exact copy. The resulting work is called a "modified version" of the
|
|
||||||
earlier work or a work "based on" the earlier work.
|
|
||||||
|
|
||||||
A "covered work" means either the unmodified Program or a work based
|
|
||||||
on the Program.
|
|
||||||
|
|
||||||
To "propagate" a work means to do anything with it that, without
|
|
||||||
permission, would make you directly or secondarily liable for
|
|
||||||
infringement under applicable copyright law, except executing it on a
|
|
||||||
computer or modifying a private copy. Propagation includes copying,
|
|
||||||
distribution (with or without modification), making available to the
|
|
||||||
public, and in some countries other activities as well.
|
|
||||||
|
|
||||||
To "convey" a work means any kind of propagation that enables other
|
|
||||||
parties to make or receive copies. Mere interaction with a user through
|
|
||||||
a computer network, with no transfer of a copy, is not conveying.
|
|
||||||
|
|
||||||
An interactive user interface displays "Appropriate Legal Notices"
|
|
||||||
to the extent that it includes a convenient and prominently visible
|
|
||||||
feature that (1) displays an appropriate copyright notice, and (2)
|
|
||||||
tells the user that there is no warranty for the work (except to the
|
|
||||||
extent that warranties are provided), that licensees may convey the
|
|
||||||
work under this License, and how to view a copy of this License. If
|
|
||||||
the interface presents a list of user commands or options, such as a
|
|
||||||
menu, a prominent item in the list meets this criterion.
|
|
||||||
|
|
||||||
1. Source Code.
|
|
||||||
|
|
||||||
The "source code" for a work means the preferred form of the work
|
|
||||||
for making modifications to it. "Object code" means any non-source
|
|
||||||
form of a work.
|
|
||||||
|
|
||||||
A "Standard Interface" means an interface that either is an official
|
|
||||||
standard defined by a recognized standards body, or, in the case of
|
|
||||||
interfaces specified for a particular programming language, one that
|
|
||||||
is widely used among developers working in that language.
|
|
||||||
|
|
||||||
The "System Libraries" of an executable work include anything, other
|
|
||||||
than the work as a whole, that (a) is included in the normal form of
|
|
||||||
packaging a Major Component, but which is not part of that Major
|
|
||||||
Component, and (b) serves only to enable use of the work with that
|
|
||||||
Major Component, or to implement a Standard Interface for which an
|
|
||||||
implementation is available to the public in source code form. A
|
|
||||||
"Major Component", in this context, means a major essential component
|
|
||||||
(kernel, window system, and so on) of the specific operating system
|
|
||||||
(if any) on which the executable work runs, or a compiler used to
|
|
||||||
produce the work, or an object code interpreter used to run it.
|
|
||||||
|
|
||||||
The "Corresponding Source" for a work in object code form means all
|
|
||||||
the source code needed to generate, install, and (for an executable
|
|
||||||
work) run the object code and to modify the work, including scripts to
|
|
||||||
control those activities. However, it does not include the work's
|
|
||||||
System Libraries, or general-purpose tools or generally available free
|
|
||||||
programs which are used unmodified in performing those activities but
|
|
||||||
which are not part of the work. For example, Corresponding Source
|
|
||||||
includes interface definition files associated with source files for
|
|
||||||
the work, and the source code for shared libraries and dynamically
|
|
||||||
linked subprograms that the work is specifically designed to require,
|
|
||||||
such as by intimate data communication or control flow between those
|
|
||||||
subprograms and other parts of the work.
|
|
||||||
|
|
||||||
The Corresponding Source need not include anything that users
|
|
||||||
can regenerate automatically from other parts of the Corresponding
|
|
||||||
Source.
|
|
||||||
|
|
||||||
The Corresponding Source for a work in source code form is that
|
|
||||||
same work.
|
|
||||||
|
|
||||||
2. Basic Permissions.
|
|
||||||
|
|
||||||
All rights granted under this License are granted for the term of
|
|
||||||
copyright on the Program, and are irrevocable provided the stated
|
|
||||||
conditions are met. This License explicitly affirms your unlimited
|
|
||||||
permission to run the unmodified Program. The output from running a
|
|
||||||
covered work is covered by this License only if the output, given its
|
|
||||||
content, constitutes a covered work. This License acknowledges your
|
|
||||||
rights of fair use or other equivalent, as provided by copyright law.
|
|
||||||
|
|
||||||
You may make, run and propagate covered works that you do not
|
|
||||||
convey, without conditions so long as your license otherwise remains
|
|
||||||
in force. You may convey covered works to others for the sole purpose
|
|
||||||
of having them make modifications exclusively for you, or provide you
|
|
||||||
with facilities for running those works, provided that you comply with
|
|
||||||
the terms of this License in conveying all material for which you do
|
|
||||||
not control copyright. Those thus making or running the covered works
|
|
||||||
for you must do so exclusively on your behalf, under your direction
|
|
||||||
and control, on terms that prohibit them from making any copies of
|
|
||||||
your copyrighted material outside their relationship with you.
|
|
||||||
|
|
||||||
Conveying under any other circumstances is permitted solely under
|
|
||||||
the conditions stated below. Sublicensing is not allowed; section 10
|
|
||||||
makes it unnecessary.
|
|
||||||
|
|
||||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
|
||||||
|
|
||||||
No covered work shall be deemed part of an effective technological
|
|
||||||
measure under any applicable law fulfilling obligations under article
|
|
||||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
|
||||||
similar laws prohibiting or restricting circumvention of such
|
|
||||||
measures.
|
|
||||||
|
|
||||||
When you convey a covered work, you waive any legal power to forbid
|
|
||||||
circumvention of technological measures to the extent such circumvention
|
|
||||||
is effected by exercising rights under this License with respect to
|
|
||||||
the covered work, and you disclaim any intention to limit operation or
|
|
||||||
modification of the work as a means of enforcing, against the work's
|
|
||||||
users, your or third parties' legal rights to forbid circumvention of
|
|
||||||
technological measures.
|
|
||||||
|
|
||||||
4. Conveying Verbatim Copies.
|
|
||||||
|
|
||||||
You may convey verbatim copies of the Program's source code as you
|
|
||||||
receive it, in any medium, provided that you conspicuously and
|
|
||||||
appropriately publish on each copy an appropriate copyright notice;
|
|
||||||
keep intact all notices stating that this License and any
|
|
||||||
non-permissive terms added in accord with section 7 apply to the code;
|
|
||||||
keep intact all notices of the absence of any warranty; and give all
|
|
||||||
recipients a copy of this License along with the Program.
|
|
||||||
|
|
||||||
You may charge any price or no price for each copy that you convey,
|
|
||||||
and you may offer support or warranty protection for a fee.
|
|
||||||
|
|
||||||
5. Conveying Modified Source Versions.
|
|
||||||
|
|
||||||
You may convey a work based on the Program, or the modifications to
|
|
||||||
produce it from the Program, in the form of source code under the
|
|
||||||
terms of section 4, provided that you also meet all of these conditions:
|
|
||||||
|
|
||||||
a) The work must carry prominent notices stating that you modified
|
|
||||||
it, and giving a relevant date.
|
|
||||||
|
|
||||||
b) The work must carry prominent notices stating that it is
|
|
||||||
released under this License and any conditions added under section
|
|
||||||
7. This requirement modifies the requirement in section 4 to
|
|
||||||
"keep intact all notices".
|
|
||||||
|
|
||||||
c) You must license the entire work, as a whole, under this
|
|
||||||
License to anyone who comes into possession of a copy. This
|
|
||||||
License will therefore apply, along with any applicable section 7
|
|
||||||
additional terms, to the whole of the work, and all its parts,
|
|
||||||
regardless of how they are packaged. This License gives no
|
|
||||||
permission to license the work in any other way, but it does not
|
|
||||||
invalidate such permission if you have separately received it.
|
|
||||||
|
|
||||||
d) If the work has interactive user interfaces, each must display
|
|
||||||
Appropriate Legal Notices; however, if the Program has interactive
|
|
||||||
interfaces that do not display Appropriate Legal Notices, your
|
|
||||||
work need not make them do so.
|
|
||||||
|
|
||||||
A compilation of a covered work with other separate and independent
|
|
||||||
works, which are not by their nature extensions of the covered work,
|
|
||||||
and which are not combined with it such as to form a larger program,
|
|
||||||
in or on a volume of a storage or distribution medium, is called an
|
|
||||||
"aggregate" if the compilation and its resulting copyright are not
|
|
||||||
used to limit the access or legal rights of the compilation's users
|
|
||||||
beyond what the individual works permit. Inclusion of a covered work
|
|
||||||
in an aggregate does not cause this License to apply to the other
|
|
||||||
parts of the aggregate.
|
|
||||||
|
|
||||||
6. Conveying Non-Source Forms.
|
|
||||||
|
|
||||||
You may convey a covered work in object code form under the terms
|
|
||||||
of sections 4 and 5, provided that you also convey the
|
|
||||||
machine-readable Corresponding Source under the terms of this License,
|
|
||||||
in one of these ways:
|
|
||||||
|
|
||||||
a) Convey the object code in, or embodied in, a physical product
|
|
||||||
(including a physical distribution medium), accompanied by the
|
|
||||||
Corresponding Source fixed on a durable physical medium
|
|
||||||
customarily used for software interchange.
|
|
||||||
|
|
||||||
b) Convey the object code in, or embodied in, a physical product
|
|
||||||
(including a physical distribution medium), accompanied by a
|
|
||||||
written offer, valid for at least three years and valid for as
|
|
||||||
long as you offer spare parts or customer support for that product
|
|
||||||
model, to give anyone who possesses the object code either (1) a
|
|
||||||
copy of the Corresponding Source for all the software in the
|
|
||||||
product that is covered by this License, on a durable physical
|
|
||||||
medium customarily used for software interchange, for a price no
|
|
||||||
more than your reasonable cost of physically performing this
|
|
||||||
conveying of source, or (2) access to copy the
|
|
||||||
Corresponding Source from a network server at no charge.
|
|
||||||
|
|
||||||
c) Convey individual copies of the object code with a copy of the
|
|
||||||
written offer to provide the Corresponding Source. This
|
|
||||||
alternative is allowed only occasionally and noncommercially, and
|
|
||||||
only if you received the object code with such an offer, in accord
|
|
||||||
with subsection 6b.
|
|
||||||
|
|
||||||
d) Convey the object code by offering access from a designated
|
|
||||||
place (gratis or for a charge), and offer equivalent access to the
|
|
||||||
Corresponding Source in the same way through the same place at no
|
|
||||||
further charge. You need not require recipients to copy the
|
|
||||||
Corresponding Source along with the object code. If the place to
|
|
||||||
copy the object code is a network server, the Corresponding Source
|
|
||||||
may be on a different server (operated by you or a third party)
|
|
||||||
that supports equivalent copying facilities, provided you maintain
|
|
||||||
clear directions next to the object code saying where to find the
|
|
||||||
Corresponding Source. Regardless of what server hosts the
|
|
||||||
Corresponding Source, you remain obligated to ensure that it is
|
|
||||||
available for as long as needed to satisfy these requirements.
|
|
||||||
|
|
||||||
e) Convey the object code using peer-to-peer transmission, provided
|
|
||||||
you inform other peers where the object code and Corresponding
|
|
||||||
Source of the work are being offered to the general public at no
|
|
||||||
charge under subsection 6d.
|
|
||||||
|
|
||||||
A separable portion of the object code, whose source code is excluded
|
|
||||||
from the Corresponding Source as a System Library, need not be
|
|
||||||
included in conveying the object code work.
|
|
||||||
|
|
||||||
A "User Product" is either (1) a "consumer product", which means any
|
|
||||||
tangible personal property which is normally used for personal, family,
|
|
||||||
or household purposes, or (2) anything designed or sold for incorporation
|
|
||||||
into a dwelling. In determining whether a product is a consumer product,
|
|
||||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
|
||||||
product received by a particular user, "normally used" refers to a
|
|
||||||
typical or common use of that class of product, regardless of the status
|
|
||||||
of the particular user or of the way in which the particular user
|
|
||||||
actually uses, or expects or is expected to use, the product. A product
|
|
||||||
is a consumer product regardless of whether the product has substantial
|
|
||||||
commercial, industrial or non-consumer uses, unless such uses represent
|
|
||||||
the only significant mode of use of the product.
|
|
||||||
|
|
||||||
"Installation Information" for a User Product means any methods,
|
|
||||||
procedures, authorization keys, or other information required to install
|
|
||||||
and execute modified versions of a covered work in that User Product from
|
|
||||||
a modified version of its Corresponding Source. The information must
|
|
||||||
suffice to ensure that the continued functioning of the modified object
|
|
||||||
code is in no case prevented or interfered with solely because
|
|
||||||
modification has been made.
|
|
||||||
|
|
||||||
If you convey an object code work under this section in, or with, or
|
|
||||||
specifically for use in, a User Product, and the conveying occurs as
|
|
||||||
part of a transaction in which the right of possession and use of the
|
|
||||||
User Product is transferred to the recipient in perpetuity or for a
|
|
||||||
fixed term (regardless of how the transaction is characterized), the
|
|
||||||
Corresponding Source conveyed under this section must be accompanied
|
|
||||||
by the Installation Information. But this requirement does not apply
|
|
||||||
if neither you nor any third party retains the ability to install
|
|
||||||
modified object code on the User Product (for example, the work has
|
|
||||||
been installed in ROM).
|
|
||||||
|
|
||||||
The requirement to provide Installation Information does not include a
|
|
||||||
requirement to continue to provide support service, warranty, or updates
|
|
||||||
for a work that has been modified or installed by the recipient, or for
|
|
||||||
the User Product in which it has been modified or installed. Access to a
|
|
||||||
network may be denied when the modification itself materially and
|
|
||||||
adversely affects the operation of the network or violates the rules and
|
|
||||||
protocols for communication across the network.
|
|
||||||
|
|
||||||
Corresponding Source conveyed, and Installation Information provided,
|
|
||||||
in accord with this section must be in a format that is publicly
|
|
||||||
documented (and with an implementation available to the public in
|
|
||||||
source code form), and must require no special password or key for
|
|
||||||
unpacking, reading or copying.
|
|
||||||
|
|
||||||
7. Additional Terms.
|
|
||||||
|
|
||||||
"Additional permissions" are terms that supplement the terms of this
|
|
||||||
License by making exceptions from one or more of its conditions.
|
|
||||||
Additional permissions that are applicable to the entire Program shall
|
|
||||||
be treated as though they were included in this License, to the extent
|
|
||||||
that they are valid under applicable law. If additional permissions
|
|
||||||
apply only to part of the Program, that part may be used separately
|
|
||||||
under those permissions, but the entire Program remains governed by
|
|
||||||
this License without regard to the additional permissions.
|
|
||||||
|
|
||||||
When you convey a copy of a covered work, you may at your option
|
|
||||||
remove any additional permissions from that copy, or from any part of
|
|
||||||
it. (Additional permissions may be written to require their own
|
|
||||||
removal in certain cases when you modify the work.) You may place
|
|
||||||
additional permissions on material, added by you to a covered work,
|
|
||||||
for which you have or can give appropriate copyright permission.
|
|
||||||
|
|
||||||
Notwithstanding any other provision of this License, for material you
|
|
||||||
add to a covered work, you may (if authorized by the copyright holders of
|
|
||||||
that material) supplement the terms of this License with terms:
|
|
||||||
|
|
||||||
a) Disclaiming warranty or limiting liability differently from the
|
|
||||||
terms of sections 15 and 16 of this License; or
|
|
||||||
|
|
||||||
b) Requiring preservation of specified reasonable legal notices or
|
|
||||||
author attributions in that material or in the Appropriate Legal
|
|
||||||
Notices displayed by works containing it; or
|
|
||||||
|
|
||||||
c) Prohibiting misrepresentation of the origin of that material, or
|
|
||||||
requiring that modified versions of such material be marked in
|
|
||||||
reasonable ways as different from the original version; or
|
|
||||||
|
|
||||||
d) Limiting the use for publicity purposes of names of licensors or
|
|
||||||
authors of the material; or
|
|
||||||
|
|
||||||
e) Declining to grant rights under trademark law for use of some
|
|
||||||
trade names, trademarks, or service marks; or
|
|
||||||
|
|
||||||
f) Requiring indemnification of licensors and authors of that
|
|
||||||
material by anyone who conveys the material (or modified versions of
|
|
||||||
it) with contractual assumptions of liability to the recipient, for
|
|
||||||
any liability that these contractual assumptions directly impose on
|
|
||||||
those licensors and authors.
|
|
||||||
|
|
||||||
All other non-permissive additional terms are considered "further
|
|
||||||
restrictions" within the meaning of section 10. If the Program as you
|
|
||||||
received it, or any part of it, contains a notice stating that it is
|
|
||||||
governed by this License along with a term that is a further
|
|
||||||
restriction, you may remove that term. If a license document contains
|
|
||||||
a further restriction but permits relicensing or conveying under this
|
|
||||||
License, you may add to a covered work material governed by the terms
|
|
||||||
of that license document, provided that the further restriction does
|
|
||||||
not survive such relicensing or conveying.
|
|
||||||
|
|
||||||
If you add terms to a covered work in accord with this section, you
|
|
||||||
must place, in the relevant source files, a statement of the
|
|
||||||
additional terms that apply to those files, or a notice indicating
|
|
||||||
where to find the applicable terms.
|
|
||||||
|
|
||||||
Additional terms, permissive or non-permissive, may be stated in the
|
|
||||||
form of a separately written license, or stated as exceptions;
|
|
||||||
the above requirements apply either way.
|
|
||||||
|
|
||||||
8. Termination.
|
|
||||||
|
|
||||||
You may not propagate or modify a covered work except as expressly
|
|
||||||
provided under this License. Any attempt otherwise to propagate or
|
|
||||||
modify it is void, and will automatically terminate your rights under
|
|
||||||
this License (including any patent licenses granted under the third
|
|
||||||
paragraph of section 11).
|
|
||||||
|
|
||||||
However, if you cease all violation of this License, then your
|
|
||||||
license from a particular copyright holder is reinstated (a)
|
|
||||||
provisionally, unless and until the copyright holder explicitly and
|
|
||||||
finally terminates your license, and (b) permanently, if the copyright
|
|
||||||
holder fails to notify you of the violation by some reasonable means
|
|
||||||
prior to 60 days after the cessation.
|
|
||||||
|
|
||||||
Moreover, your license from a particular copyright holder is
|
|
||||||
reinstated permanently if the copyright holder notifies you of the
|
|
||||||
violation by some reasonable means, this is the first time you have
|
|
||||||
received notice of violation of this License (for any work) from that
|
|
||||||
copyright holder, and you cure the violation prior to 30 days after
|
|
||||||
your receipt of the notice.
|
|
||||||
|
|
||||||
Termination of your rights under this section does not terminate the
|
|
||||||
licenses of parties who have received copies or rights from you under
|
|
||||||
this License. If your rights have been terminated and not permanently
|
|
||||||
reinstated, you do not qualify to receive new licenses for the same
|
|
||||||
material under section 10.
|
|
||||||
|
|
||||||
9. Acceptance Not Required for Having Copies.
|
|
||||||
|
|
||||||
You are not required to accept this License in order to receive or
|
|
||||||
run a copy of the Program. Ancillary propagation of a covered work
|
|
||||||
occurring solely as a consequence of using peer-to-peer transmission
|
|
||||||
to receive a copy likewise does not require acceptance. However,
|
|
||||||
nothing other than this License grants you permission to propagate or
|
|
||||||
modify any covered work. These actions infringe copyright if you do
|
|
||||||
not accept this License. Therefore, by modifying or propagating a
|
|
||||||
covered work, you indicate your acceptance of this License to do so.
|
|
||||||
|
|
||||||
10. Automatic Licensing of Downstream Recipients.
|
|
||||||
|
|
||||||
Each time you convey a covered work, the recipient automatically
|
|
||||||
receives a license from the original licensors, to run, modify and
|
|
||||||
propagate that work, subject to this License. You are not responsible
|
|
||||||
for enforcing compliance by third parties with this License.
|
|
||||||
|
|
||||||
An "entity transaction" is a transaction transferring control of an
|
|
||||||
organization, or substantially all assets of one, or subdividing an
|
|
||||||
organization, or merging organizations. If propagation of a covered
|
|
||||||
work results from an entity transaction, each party to that
|
|
||||||
transaction who receives a copy of the work also receives whatever
|
|
||||||
licenses to the work the party's predecessor in interest had or could
|
|
||||||
give under the previous paragraph, plus a right to possession of the
|
|
||||||
Corresponding Source of the work from the predecessor in interest, if
|
|
||||||
the predecessor has it or can get it with reasonable efforts.
|
|
||||||
|
|
||||||
You may not impose any further restrictions on the exercise of the
|
|
||||||
rights granted or affirmed under this License. For example, you may
|
|
||||||
not impose a license fee, royalty, or other charge for exercise of
|
|
||||||
rights granted under this License, and you may not initiate litigation
|
|
||||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
|
||||||
any patent claim is infringed by making, using, selling, offering for
|
|
||||||
sale, or importing the Program or any portion of it.
|
|
||||||
|
|
||||||
11. Patents.
|
|
||||||
|
|
||||||
A "contributor" is a copyright holder who authorizes use under this
|
|
||||||
License of the Program or a work on which the Program is based. The
|
|
||||||
work thus licensed is called the contributor's "contributor version".
|
|
||||||
|
|
||||||
A contributor's "essential patent claims" are all patent claims
|
|
||||||
owned or controlled by the contributor, whether already acquired or
|
|
||||||
hereafter acquired, that would be infringed by some manner, permitted
|
|
||||||
by this License, of making, using, or selling its contributor version,
|
|
||||||
but do not include claims that would be infringed only as a
|
|
||||||
consequence of further modification of the contributor version. For
|
|
||||||
purposes of this definition, "control" includes the right to grant
|
|
||||||
patent sublicenses in a manner consistent with the requirements of
|
|
||||||
this License.
|
|
||||||
|
|
||||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
|
||||||
patent license under the contributor's essential patent claims, to
|
|
||||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
|
||||||
propagate the contents of its contributor version.
|
|
||||||
|
|
||||||
In the following three paragraphs, a "patent license" is any express
|
|
||||||
agreement or commitment, however denominated, not to enforce a patent
|
|
||||||
(such as an express permission to practice a patent or covenant not to
|
|
||||||
sue for patent infringement). To "grant" such a patent license to a
|
|
||||||
party means to make such an agreement or commitment not to enforce a
|
|
||||||
patent against the party.
|
|
||||||
|
|
||||||
If you convey a covered work, knowingly relying on a patent license,
|
|
||||||
and the Corresponding Source of the work is not available for anyone
|
|
||||||
to copy, free of charge and under the terms of this License, through a
|
|
||||||
publicly available network server or other readily accessible means,
|
|
||||||
then you must either (1) cause the Corresponding Source to be so
|
|
||||||
available, or (2) arrange to deprive yourself of the benefit of the
|
|
||||||
patent license for this particular work, or (3) arrange, in a manner
|
|
||||||
consistent with the requirements of this License, to extend the patent
|
|
||||||
license to downstream recipients. "Knowingly relying" means you have
|
|
||||||
actual knowledge that, but for the patent license, your conveying the
|
|
||||||
covered work in a country, or your recipient's use of the covered work
|
|
||||||
in a country, would infringe one or more identifiable patents in that
|
|
||||||
country that you have reason to believe are valid.
|
|
||||||
|
|
||||||
If, pursuant to or in connection with a single transaction or
|
|
||||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
|
||||||
covered work, and grant a patent license to some of the parties
|
|
||||||
receiving the covered work authorizing them to use, propagate, modify
|
|
||||||
or convey a specific copy of the covered work, then the patent license
|
|
||||||
you grant is automatically extended to all recipients of the covered
|
|
||||||
work and works based on it.
|
|
||||||
|
|
||||||
A patent license is "discriminatory" if it does not include within
|
|
||||||
the scope of its coverage, prohibits the exercise of, or is
|
|
||||||
conditioned on the non-exercise of one or more of the rights that are
|
|
||||||
specifically granted under this License. You may not convey a covered
|
|
||||||
work if you are a party to an arrangement with a third party that is
|
|
||||||
in the business of distributing software, under which you make payment
|
|
||||||
to the third party based on the extent of your activity of conveying
|
|
||||||
the work, and under which the third party grants, to any of the
|
|
||||||
parties who would receive the covered work from you, a discriminatory
|
|
||||||
patent license (a) in connection with copies of the covered work
|
|
||||||
conveyed by you (or copies made from those copies), or (b) primarily
|
|
||||||
for and in connection with specific products or compilations that
|
|
||||||
contain the covered work, unless you entered into that arrangement,
|
|
||||||
or that patent license was granted, prior to 28 March 2007.
|
|
||||||
|
|
||||||
Nothing in this License shall be construed as excluding or limiting
|
|
||||||
any implied license or other defenses to infringement that may
|
|
||||||
otherwise be available to you under applicable patent law.
|
|
||||||
|
|
||||||
12. No Surrender of Others' Freedom.
|
|
||||||
|
|
||||||
If conditions are imposed on you (whether by court order, agreement or
|
|
||||||
otherwise) that contradict the conditions of this License, they do not
|
|
||||||
excuse you from the conditions of this License. If you cannot convey a
|
|
||||||
covered work so as to satisfy simultaneously your obligations under this
|
|
||||||
License and any other pertinent obligations, then as a consequence you may
|
|
||||||
not convey it at all. For example, if you agree to terms that obligate you
|
|
||||||
to collect a royalty for further conveying from those to whom you convey
|
|
||||||
the Program, the only way you could satisfy both those terms and this
|
|
||||||
License would be to refrain entirely from conveying the Program.
|
|
||||||
|
|
||||||
13. Use with the GNU Affero General Public License.
|
|
||||||
|
|
||||||
Notwithstanding any other provision of this License, you have
|
|
||||||
permission to link or combine any covered work with a work licensed
|
|
||||||
under version 3 of the GNU Affero General Public License into a single
|
|
||||||
combined work, and to convey the resulting work. The terms of this
|
|
||||||
License will continue to apply to the part which is the covered work,
|
|
||||||
but the special requirements of the GNU Affero General Public License,
|
|
||||||
section 13, concerning interaction through a network will apply to the
|
|
||||||
combination as such.
|
|
||||||
|
|
||||||
14. Revised Versions of this License.
|
|
||||||
|
|
||||||
The Free Software Foundation may publish revised and/or new versions of
|
|
||||||
the GNU General Public License from time to time. Such new versions will
|
|
||||||
be similar in spirit to the present version, but may differ in detail to
|
|
||||||
address new problems or concerns.
|
|
||||||
|
|
||||||
Each version is given a distinguishing version number. If the
|
|
||||||
Program specifies that a certain numbered version of the GNU General
|
|
||||||
Public License "or any later version" applies to it, you have the
|
|
||||||
option of following the terms and conditions either of that numbered
|
|
||||||
version or of any later version published by the Free Software
|
|
||||||
Foundation. If the Program does not specify a version number of the
|
|
||||||
GNU General Public License, you may choose any version ever published
|
|
||||||
by the Free Software Foundation.
|
|
||||||
|
|
||||||
If the Program specifies that a proxy can decide which future
|
|
||||||
versions of the GNU General Public License can be used, that proxy's
|
|
||||||
public statement of acceptance of a version permanently authorizes you
|
|
||||||
to choose that version for the Program.
|
|
||||||
|
|
||||||
Later license versions may give you additional or different
|
|
||||||
permissions. However, no additional obligations are imposed on any
|
|
||||||
author or copyright holder as a result of your choosing to follow a
|
|
||||||
later version.
|
|
||||||
|
|
||||||
15. Disclaimer of Warranty.
|
|
||||||
|
|
||||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
|
||||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
|
||||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
|
||||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
|
||||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
||||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
|
||||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
|
||||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
|
||||||
|
|
||||||
16. Limitation of Liability.
|
|
||||||
|
|
||||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
|
||||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
|
||||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
|
||||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
|
||||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
|
||||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
|
||||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
|
||||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
|
||||||
SUCH DAMAGES.
|
|
||||||
|
|
||||||
17. Interpretation of Sections 15 and 16.
|
|
||||||
|
|
||||||
If the disclaimer of warranty and limitation of liability provided
|
|
||||||
above cannot be given local legal effect according to their terms,
|
|
||||||
reviewing courts shall apply local law that most closely approximates
|
|
||||||
an absolute waiver of all civil liability in connection with the
|
|
||||||
Program, unless a warranty or assumption of liability accompanies a
|
|
||||||
copy of the Program in return for a fee.
|
|
||||||
|
|
||||||
END OF TERMS AND CONDITIONS
|
|
||||||
|
|
||||||
How to Apply These Terms to Your New Programs
|
|
||||||
|
|
||||||
If you develop a new program, and you want it to be of the greatest
|
|
||||||
possible use to the public, the best way to achieve this is to make it
|
|
||||||
free software which everyone can redistribute and change under these terms.
|
|
||||||
|
|
||||||
To do so, attach the following notices to the program. It is safest
|
|
||||||
to attach them to the start of each source file to most effectively
|
|
||||||
state the exclusion of warranty; and each file should have at least
|
|
||||||
the "copyright" line and a pointer to where the full notice is found.
|
|
||||||
|
|
||||||
<one line to give the program's name and a brief idea of what it does.>
|
|
||||||
Copyright (C) <year> <name of author>
|
|
||||||
|
|
||||||
This program is free software: you can redistribute it and/or modify
|
|
||||||
it under the terms of the GNU General Public License as published by
|
|
||||||
the Free Software Foundation, either version 3 of the License, or
|
|
||||||
(at your option) any later version.
|
|
||||||
|
|
||||||
This program is distributed in the hope that it will be useful,
|
|
||||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
||||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
||||||
GNU General Public License for more details.
|
|
||||||
|
|
||||||
You should have received a copy of the GNU General Public License
|
|
||||||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
||||||
|
|
||||||
Also add information on how to contact you by electronic and paper mail.
|
|
||||||
|
|
||||||
If the program does terminal interaction, make it output a short
|
|
||||||
notice like this when it starts in an interactive mode:
|
|
||||||
|
|
||||||
<program> Copyright (C) <year> <name of author>
|
|
||||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
|
||||||
This is free software, and you are welcome to redistribute it
|
|
||||||
under certain conditions; type `show c' for details.
|
|
||||||
|
|
||||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
|
||||||
parts of the General Public License. Of course, your program's commands
|
|
||||||
might be different; for a GUI interface, you would use an "about box".
|
|
||||||
|
|
||||||
You should also get your employer (if you work as a programmer) or school,
|
|
||||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
|
||||||
For more information on this, and how to apply and follow the GNU GPL, see
|
|
||||||
<https://www.gnu.org/licenses/>.
|
|
||||||
|
|
||||||
The GNU General Public License does not permit incorporating your program
|
|
||||||
into proprietary programs. If your program is a subroutine library, you
|
|
||||||
may consider it more useful to permit linking proprietary applications with
|
|
||||||
the library. If this is what you want to do, use the GNU Lesser General
|
|
||||||
Public License instead of this License. But first, please read
|
|
||||||
<https://www.gnu.org/licenses/why-not-lgpl.html>.
|
|
||||||
37
backend/.gitignore
vendored
37
backend/.gitignore
vendored
@ -1,37 +0,0 @@
|
|||||||
HELP.md
|
|
||||||
target/
|
|
||||||
!.mvn/wrapper/maven-wrapper.jar
|
|
||||||
!**/src/main/**/target/
|
|
||||||
!**/src/test/**/target/
|
|
||||||
|
|
||||||
### STS ###
|
|
||||||
.apt_generated
|
|
||||||
.classpath
|
|
||||||
.factorypath
|
|
||||||
.project
|
|
||||||
.settings
|
|
||||||
.springBeans
|
|
||||||
.sts4-cache
|
|
||||||
|
|
||||||
### IntelliJ IDEA ###
|
|
||||||
.idea
|
|
||||||
*.iws
|
|
||||||
*.iml
|
|
||||||
*.ipr
|
|
||||||
|
|
||||||
### NetBeans ###
|
|
||||||
/nbproject/private/
|
|
||||||
/nbbuild/
|
|
||||||
/dist/
|
|
||||||
/nbdist/
|
|
||||||
/.nb-gradle/
|
|
||||||
build/
|
|
||||||
!**/src/main/**/build/
|
|
||||||
!**/src/test/**/build/
|
|
||||||
|
|
||||||
### VS Code ###
|
|
||||||
.vscode/
|
|
||||||
|
|
||||||
## 排除 application-test.yml 和 application-prod.yml
|
|
||||||
|
|
||||||
application-dev.yml
|
|
||||||
8
backend/.idea/sqldialects.xml
Normal file
8
backend/.idea/sqldialects.xml
Normal file
@ -0,0 +1,8 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<project version="4">
|
||||||
|
<component name="SqlDialectMappings">
|
||||||
|
<file url="file://$PROJECT_DIR$/src/main/resources/mapper/NoteMapper.xml" dialect="GenericSQL" />
|
||||||
|
<file url="file://$PROJECT_DIR$/src/main/resources/mapper/UserMapper.xml" dialect="MySQL" />
|
||||||
|
<file url="PROJECT" dialect="MySQL" />
|
||||||
|
</component>
|
||||||
|
</project>
|
||||||
19
backend/.mvn/wrapper/maven-wrapper.properties
vendored
19
backend/.mvn/wrapper/maven-wrapper.properties
vendored
@ -1,19 +0,0 @@
|
|||||||
# Licensed to the Apache Software Foundation (ASF) under one
|
|
||||||
# or more contributor license agreements. See the NOTICE file
|
|
||||||
# distributed with this work for additional information
|
|
||||||
# regarding copyright ownership. The ASF licenses this file
|
|
||||||
# to you under the Apache License, Version 2.0 (the
|
|
||||||
# "License"); you may not use this file except in compliance
|
|
||||||
# with the License. You may obtain a copy of the License at
|
|
||||||
#
|
|
||||||
# http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
#
|
|
||||||
# Unless required by applicable law or agreed to in writing,
|
|
||||||
# software distributed under the License is distributed on an
|
|
||||||
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
||||||
# KIND, either express or implied. See the License for the
|
|
||||||
# specific language governing permissions and limitations
|
|
||||||
# under the License.
|
|
||||||
wrapperVersion=3.3.2
|
|
||||||
distributionType=only-script
|
|
||||||
distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip
|
|
||||||
@ -1,23 +0,0 @@
|
|||||||
# 构建阶段
|
|
||||||
FROM maven:3.9.9-amazoncorretto-17 AS build
|
|
||||||
|
|
||||||
WORKDIR /app
|
|
||||||
|
|
||||||
# 复制文件并忽略不必要的内容（通过 .dockerignore 配置）
|
|
||||||
COPY . .
|
|
||||||
|
|
||||||
# 使用 Maven 构建项目
|
|
||||||
RUN mvn -B clean package -DskipTests
|
|
||||||
|
|
||||||
# 运行阶段
|
|
||||||
FROM openjdk:17
|
|
||||||
|
|
||||||
WORKDIR /app
|
|
||||||
|
|
||||||
# 将构建产物复制到运行镜像
|
|
||||||
COPY --from=build /app/target/*.jar app.jar
|
|
||||||
|
|
||||||
# 设置启动命令并暴露端口
|
|
||||||
CMD ["java", "-Dspring.profiles.active=dev", "-jar", "app.jar"]
|
|
||||||
|
|
||||||
EXPOSE 8080
|
|
||||||
259
backend/mvnw
vendored
259
backend/mvnw
vendored
@ -1,259 +0,0 @@
|
|||||||
#!/bin/sh
|
|
||||||
# ----------------------------------------------------------------------------
|
|
||||||
# Licensed to the Apache Software Foundation (ASF) under one
|
|
||||||
# or more contributor license agreements. See the NOTICE file
|
|
||||||
# distributed with this work for additional information
|
|
||||||
# regarding copyright ownership. The ASF licenses this file
|
|
||||||
# to you under the Apache License, Version 2.0 (the
|
|
||||||
# "License"); you may not use this file except in compliance
|
|
||||||
# with the License. You may obtain a copy of the License at
|
|
||||||
#
|
|
||||||
# http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
#
|
|
||||||
# Unless required by applicable law or agreed to in writing,
|
|
||||||
# software distributed under the License is distributed on an
|
|
||||||
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
||||||
# KIND, either express or implied. See the License for the
|
|
||||||
# specific language governing permissions and limitations
|
|
||||||
# under the License.
|
|
||||||
# ----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
# ----------------------------------------------------------------------------
|
|
||||||
# Apache Maven Wrapper startup batch script, version 3.3.2
|
|
||||||
#
|
|
||||||
# Optional ENV vars
|
|
||||||
# -----------------
|
|
||||||
# JAVA_HOME - location of a JDK home dir, required when download maven via java source
|
|
||||||
# MVNW_REPOURL - repo url base for downloading maven distribution
|
|
||||||
# MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
|
|
||||||
# MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output
|
|
||||||
# ----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
set -euf
|
|
||||||
[ "${MVNW_VERBOSE-}" != debug ] || set -x
|
|
||||||
|
|
||||||
# OS specific support.
|
|
||||||
native_path() { printf %s\\n "$1"; }
|
|
||||||
case "$(uname)" in
|
|
||||||
CYGWIN* | MINGW*)
|
|
||||||
[ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")"
|
|
||||||
native_path() { cygpath --path --windows "$1"; }
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
# set JAVACMD and JAVACCMD
|
|
||||||
set_java_home() {
|
|
||||||
# For Cygwin and MinGW, ensure paths are in Unix format before anything is touched
|
|
||||||
if [ -n "${JAVA_HOME-}" ]; then
|
|
||||||
if [ -x "$JAVA_HOME/jre/sh/java" ]; then
|
|
||||||
# IBM's JDK on AIX uses strange locations for the executables
|
|
||||||
JAVACMD="$JAVA_HOME/jre/sh/java"
|
|
||||||
JAVACCMD="$JAVA_HOME/jre/sh/javac"
|
|
||||||
else
|
|
||||||
JAVACMD="$JAVA_HOME/bin/java"
|
|
||||||
JAVACCMD="$JAVA_HOME/bin/javac"
|
|
||||||
|
|
||||||
if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then
|
|
||||||
echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2
|
|
||||||
echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
JAVACMD="$(
|
|
||||||
'set' +e
|
|
||||||
'unset' -f command 2>/dev/null
|
|
||||||
'command' -v java
|
|
||||||
)" || :
|
|
||||||
JAVACCMD="$(
|
|
||||||
'set' +e
|
|
||||||
'unset' -f command 2>/dev/null
|
|
||||||
'command' -v javac
|
|
||||||
)" || :
|
|
||||||
|
|
||||||
if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then
|
|
||||||
echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
# hash string like Java String::hashCode
|
|
||||||
hash_string() {
|
|
||||||
str="${1:-}" h=0
|
|
||||||
while [ -n "$str" ]; do
|
|
||||||
char="${str%"${str#?}"}"
|
|
||||||
h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296))
|
|
||||||
str="${str#?}"
|
|
||||||
done
|
|
||||||
printf %x\\n $h
|
|
||||||
}
|
|
||||||
|
|
||||||
verbose() { :; }
|
|
||||||
[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; }
|
|
||||||
|
|
||||||
die() {
|
|
||||||
printf %s\\n "$1" >&2
|
|
||||||
exit 1
|
|
||||||
}
|
|
||||||
|
|
||||||
trim() {
|
|
||||||
# MWRAPPER-139:
|
|
||||||
# Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds.
|
|
||||||
# Needed for removing poorly interpreted newline sequences when running in more
|
|
||||||
# exotic environments such as mingw bash on Windows.
|
|
||||||
printf "%s" "${1}" | tr -d '[:space:]'
|
|
||||||
}
|
|
||||||
|
|
||||||
# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties
|
|
||||||
while IFS="=" read -r key value; do
|
|
||||||
case "${key-}" in
|
|
||||||
distributionUrl) distributionUrl=$(trim "${value-}") ;;
|
|
||||||
distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;;
|
|
||||||
esac
|
|
||||||
done <"${0%/*}/.mvn/wrapper/maven-wrapper.properties"
|
|
||||||
[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in ${0%/*}/.mvn/wrapper/maven-wrapper.properties"
|
|
||||||
|
|
||||||
case "${distributionUrl##*/}" in
|
|
||||||
maven-mvnd-*bin.*)
|
|
||||||
MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/
|
|
||||||
case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in
|
|
||||||
*AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;;
|
|
||||||
:Darwin*x86_64) distributionPlatform=darwin-amd64 ;;
|
|
||||||
:Darwin*arm64) distributionPlatform=darwin-aarch64 ;;
|
|
||||||
:Linux*x86_64*) distributionPlatform=linux-amd64 ;;
|
|
||||||
*)
|
|
||||||
echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2
|
|
||||||
distributionPlatform=linux-amd64
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip"
|
|
||||||
;;
|
|
||||||
maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;;
|
|
||||||
*) MVN_CMD="mvn${0##*/mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
# apply MVNW_REPOURL and calculate MAVEN_HOME
|
|
||||||
# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
|
|
||||||
[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}"
|
|
||||||
distributionUrlName="${distributionUrl##*/}"
|
|
||||||
distributionUrlNameMain="${distributionUrlName%.*}"
|
|
||||||
distributionUrlNameMain="${distributionUrlNameMain%-bin}"
|
|
||||||
MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}"
|
|
||||||
MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")"
|
|
||||||
|
|
||||||
exec_maven() {
|
|
||||||
unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || :
|
|
||||||
exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD"
|
|
||||||
}
|
|
||||||
|
|
||||||
if [ -d "$MAVEN_HOME" ]; then
|
|
||||||
verbose "found existing MAVEN_HOME at $MAVEN_HOME"
|
|
||||||
exec_maven "$@"
|
|
||||||
fi
|
|
||||||
|
|
||||||
case "${distributionUrl-}" in
|
|
||||||
*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;;
|
|
||||||
*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
# prepare tmp dir
|
|
||||||
if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then
|
|
||||||
clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; }
|
|
||||||
trap clean HUP INT TERM EXIT
|
|
||||||
else
|
|
||||||
die "cannot create temp dir"
|
|
||||||
fi
|
|
||||||
|
|
||||||
mkdir -p -- "${MAVEN_HOME%/*}"
|
|
||||||
|
|
||||||
# Download and Install Apache Maven
|
|
||||||
verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
|
|
||||||
verbose "Downloading from: $distributionUrl"
|
|
||||||
verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
|
|
||||||
|
|
||||||
# select .zip or .tar.gz
|
|
||||||
if ! command -v unzip >/dev/null; then
|
|
||||||
distributionUrl="${distributionUrl%.zip}.tar.gz"
|
|
||||||
distributionUrlName="${distributionUrl##*/}"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# verbose opt
|
|
||||||
__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR=''
|
|
||||||
[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v
|
|
||||||
|
|
||||||
# normalize http auth
|
|
||||||
case "${MVNW_PASSWORD:+has-password}" in
|
|
||||||
'') MVNW_USERNAME='' MVNW_PASSWORD='' ;;
|
|
||||||
has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then
|
|
||||||
verbose "Found wget ... using wget"
|
|
||||||
wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl"
|
|
||||||
elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then
|
|
||||||
verbose "Found curl ... using curl"
|
|
||||||
curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl"
|
|
||||||
elif set_java_home; then
|
|
||||||
verbose "Falling back to use Java to download"
|
|
||||||
javaSource="$TMP_DOWNLOAD_DIR/Downloader.java"
|
|
||||||
targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName"
|
|
||||||
cat >"$javaSource" <<-END
|
|
||||||
public class Downloader extends java.net.Authenticator
|
|
||||||
{
|
|
||||||
protected java.net.PasswordAuthentication getPasswordAuthentication()
|
|
||||||
{
|
|
||||||
return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() );
|
|
||||||
}
|
|
||||||
public static void main( String[] args ) throws Exception
|
|
||||||
{
|
|
||||||
setDefault( new Downloader() );
|
|
||||||
java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() );
|
|
||||||
}
|
|
||||||
}
|
|
||||||
END
|
|
||||||
# For Cygwin/MinGW, switch paths to Windows format before running javac and java
|
|
||||||
verbose " - Compiling Downloader.java ..."
|
|
||||||
"$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java"
|
|
||||||
verbose " - Running Downloader.java ..."
|
|
||||||
"$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# If specified, validate the SHA-256 sum of the Maven distribution zip file
|
|
||||||
if [ -n "${distributionSha256Sum-}" ]; then
|
|
||||||
distributionSha256Result=false
|
|
||||||
if [ "$MVN_CMD" = mvnd.sh ]; then
|
|
||||||
echo "Checksum validation is not supported for maven-mvnd." >&2
|
|
||||||
echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
|
|
||||||
exit 1
|
|
||||||
elif command -v sha256sum >/dev/null; then
|
|
||||||
if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c >/dev/null 2>&1; then
|
|
||||||
distributionSha256Result=true
|
|
||||||
fi
|
|
||||||
elif command -v shasum >/dev/null; then
|
|
||||||
if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then
|
|
||||||
distributionSha256Result=true
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2
|
|
||||||
echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
if [ $distributionSha256Result = false ]; then
|
|
||||||
echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2
|
|
||||||
echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# unzip and move
|
|
||||||
if command -v unzip >/dev/null; then
|
|
||||||
unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip"
|
|
||||||
else
|
|
||||||
tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar"
|
|
||||||
fi
|
|
||||||
printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/mvnw.url"
|
|
||||||
mv -- "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME"
|
|
||||||
|
|
||||||
clean || :
|
|
||||||
exec_maven "$@"
|
|
||||||
149
backend/mvnw.cmd
vendored
149
backend/mvnw.cmd
vendored
@ -1,149 +0,0 @@
|
|||||||
<# : batch portion
|
|
||||||
@REM ----------------------------------------------------------------------------
|
|
||||||
@REM Licensed to the Apache Software Foundation (ASF) under one
|
|
||||||
@REM or more contributor license agreements. See the NOTICE file
|
|
||||||
@REM distributed with this work for additional information
|
|
||||||
@REM regarding copyright ownership. The ASF licenses this file
|
|
||||||
@REM to you under the Apache License, Version 2.0 (the
|
|
||||||
@REM "License"); you may not use this file except in compliance
|
|
||||||
@REM with the License. You may obtain a copy of the License at
|
|
||||||
@REM
|
|
||||||
@REM http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
@REM
|
|
||||||
@REM Unless required by applicable law or agreed to in writing,
|
|
||||||
@REM software distributed under the License is distributed on an
|
|
||||||
@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
||||||
@REM KIND, either express or implied. See the License for the
|
|
||||||
@REM specific language governing permissions and limitations
|
|
||||||
@REM under the License.
|
|
||||||
@REM ----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
@REM ----------------------------------------------------------------------------
|
|
||||||
@REM Apache Maven Wrapper startup batch script, version 3.3.2
|
|
||||||
@REM
|
|
||||||
@REM Optional ENV vars
|
|
||||||
@REM MVNW_REPOURL - repo url base for downloading maven distribution
|
|
||||||
@REM MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
|
|
||||||
@REM MVNW_VERBOSE - true: enable verbose log; others: silence the output
|
|
||||||
@REM ----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0)
|
|
||||||
@SET __MVNW_CMD__=
|
|
||||||
@SET __MVNW_ERROR__=
|
|
||||||
@SET __MVNW_PSMODULEP_SAVE=%PSModulePath%
|
|
||||||
@SET PSModulePath=
|
|
||||||
@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @(
|
|
||||||
IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B)
|
|
||||||
)
|
|
||||||
@SET PSModulePath=%__MVNW_PSMODULEP_SAVE%
|
|
||||||
@SET __MVNW_PSMODULEP_SAVE=
|
|
||||||
@SET __MVNW_ARG0_NAME__=
|
|
||||||
@SET MVNW_USERNAME=
|
|
||||||
@SET MVNW_PASSWORD=
|
|
||||||
@IF NOT "%__MVNW_CMD__%"=="" (%__MVNW_CMD__% %*)
|
|
||||||
@echo Cannot start maven from wrapper >&2 && exit /b 1
|
|
||||||
@GOTO :EOF
|
|
||||||
: end batch / begin powershell #>
|
|
||||||
|
|
||||||
$ErrorActionPreference = "Stop"
|
|
||||||
if ($env:MVNW_VERBOSE -eq "true") {
|
|
||||||
$VerbosePreference = "Continue"
|
|
||||||
}
|
|
||||||
|
|
||||||
# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties
|
|
||||||
$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl
|
|
||||||
if (!$distributionUrl) {
|
|
||||||
Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
|
|
||||||
}
|
|
||||||
|
|
||||||
switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) {
|
|
||||||
"maven-mvnd-*" {
|
|
||||||
$USE_MVND = $true
|
|
||||||
$distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip"
|
|
||||||
$MVN_CMD = "mvnd.cmd"
|
|
||||||
break
|
|
||||||
}
|
|
||||||
default {
|
|
||||||
$USE_MVND = $false
|
|
||||||
$MVN_CMD = $script -replace '^mvnw','mvn'
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# apply MVNW_REPOURL and calculate MAVEN_HOME
|
|
||||||
# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
|
|
||||||
if ($env:MVNW_REPOURL) {
|
|
||||||
$MVNW_REPO_PATTERN = if ($USE_MVND) { "/org/apache/maven/" } else { "/maven/mvnd/" }
|
|
||||||
$distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace '^.*'+$MVNW_REPO_PATTERN,'')"
|
|
||||||
}
|
|
||||||
$distributionUrlName = $distributionUrl -replace '^.*/',''
|
|
||||||
$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$',''
|
|
||||||
$MAVEN_HOME_PARENT = "$HOME/.m2/wrapper/dists/$distributionUrlNameMain"
|
|
||||||
if ($env:MAVEN_USER_HOME) {
|
|
||||||
$MAVEN_HOME_PARENT = "$env:MAVEN_USER_HOME/wrapper/dists/$distributionUrlNameMain"
|
|
||||||
}
|
|
||||||
$MAVEN_HOME_NAME = ([System.Security.Cryptography.MD5]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join ''
|
|
||||||
$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME"
|
|
||||||
|
|
||||||
if (Test-Path -Path "$MAVEN_HOME" -PathType Container) {
|
|
||||||
Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME"
|
|
||||||
Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"
|
|
||||||
exit $?
|
|
||||||
}
|
|
||||||
|
|
||||||
if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) {
|
|
||||||
Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl"
|
|
||||||
}
|
|
||||||
|
|
||||||
# prepare tmp dir
|
|
||||||
$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile
|
|
||||||
$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir"
|
|
||||||
$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null
|
|
||||||
trap {
|
|
||||||
if ($TMP_DOWNLOAD_DIR.Exists) {
|
|
||||||
try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
|
|
||||||
catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null
|
|
||||||
|
|
||||||
# Download and Install Apache Maven
|
|
||||||
Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
|
|
||||||
Write-Verbose "Downloading from: $distributionUrl"
|
|
||||||
Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
|
|
||||||
|
|
||||||
$webclient = New-Object System.Net.WebClient
|
|
||||||
if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) {
|
|
||||||
$webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD)
|
|
||||||
}
|
|
||||||
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
|
|
||||||
$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null
|
|
||||||
|
|
||||||
# If specified, validate the SHA-256 sum of the Maven distribution zip file
|
|
||||||
$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum
|
|
||||||
if ($distributionSha256Sum) {
|
|
||||||
if ($USE_MVND) {
|
|
||||||
Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties."
|
|
||||||
}
|
|
||||||
Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash
|
|
||||||
if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) {
|
|
||||||
Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property."
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# unzip and move
|
|
||||||
Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null
|
|
||||||
Rename-Item -Path "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" -NewName $MAVEN_HOME_NAME | Out-Null
|
|
||||||
try {
|
|
||||||
Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null
|
|
||||||
} catch {
|
|
||||||
if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) {
|
|
||||||
Write-Error "fail to move MAVEN_HOME"
|
|
||||||
}
|
|
||||||
} finally {
|
|
||||||
try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
|
|
||||||
catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
|
|
||||||
}
|
|
||||||
|
|
||||||
Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"
|
|
||||||
150
backend/pom.xml
150
backend/pom.xml
@ -1,150 +0,0 @@
|
|||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
||||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
|
|
||||||
<modelVersion>4.0.0</modelVersion>
|
|
||||||
<parent>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-starter-parent</artifactId>
|
|
||||||
<version>2.7.18</version>
|
|
||||||
<relativePath/>
|
|
||||||
</parent>
|
|
||||||
<groupId>com.kama</groupId>
|
|
||||||
<artifactId>notes</artifactId>
|
|
||||||
<version>0.0.1</version>
|
|
||||||
<name>notes-tech</name>
|
|
||||||
<description>kamaNotes</description>
|
|
||||||
<packaging>jar</packaging>
|
|
||||||
<properties>
|
|
||||||
<java.version>17</java.version>
|
|
||||||
</properties>
|
|
||||||
<dependencies>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-starter-web</artifactId>
|
|
||||||
<exclusions>
|
|
||||||
<exclusion>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-starter-logging</artifactId>
|
|
||||||
</exclusion>
|
|
||||||
</exclusions>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-starter-security</artifactId>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.mybatis.spring.boot</groupId>
|
|
||||||
<artifactId>mybatis-spring-boot-starter</artifactId>
|
|
||||||
<version>2.2.0</version>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>mysql</groupId>
|
|
||||||
<artifactId>mysql-connector-java</artifactId>
|
|
||||||
<version>8.0.33</version>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>io.jsonwebtoken</groupId>
|
|
||||||
<artifactId>jjwt</artifactId>
|
|
||||||
<version>0.9.1</version>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.projectlombok</groupId>
|
|
||||||
<artifactId>lombok</artifactId>
|
|
||||||
<optional>true</optional>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-devtools</artifactId>
|
|
||||||
<scope>runtime</scope>
|
|
||||||
<optional>true</optional>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-starter-test</artifactId>
|
|
||||||
<scope>test</scope>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-starter-aop</artifactId>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>com.fasterxml.jackson.core</groupId>
|
|
||||||
<artifactId>jackson-databind</artifactId>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>junit</groupId>
|
|
||||||
<artifactId>junit</artifactId>
|
|
||||||
<scope>test</scope>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>javax.validation</groupId>
|
|
||||||
<artifactId>validation-api</artifactId>
|
|
||||||
<version>2.0.1.Final</version>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.hibernate.validator</groupId>
|
|
||||||
<artifactId>hibernate-validator</artifactId>
|
|
||||||
<version>6.2.4.Final</version>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>cn.hutool</groupId>
|
|
||||||
<artifactId>hutool-core</artifactId>
|
|
||||||
<version>5.8.25</version>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>jakarta.xml.bind</groupId>
|
|
||||||
<artifactId>jakarta.xml.bind-api</artifactId>
|
|
||||||
<version>2.3.2</version>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.glassfish.jaxb</groupId>
|
|
||||||
<artifactId>jaxb-runtime</artifactId>
|
|
||||||
<version>2.3.2</version>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>com.vladsch.flexmark</groupId>
|
|
||||||
<artifactId>flexmark-all</artifactId>
|
|
||||||
<version>0.64.8</version>
|
|
||||||
</dependency>
|
|
||||||
<!-- 排除 logback 改用 log4j2 -->
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-starter-log4j2</artifactId>
|
|
||||||
</dependency>
|
|
||||||
|
|
||||||
<!-- redis -->
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-starter-data-redis</artifactId>
|
|
||||||
</dependency>
|
|
||||||
</dependencies>
|
|
||||||
<build>
|
|
||||||
<plugins>
|
|
||||||
<plugin>
|
|
||||||
<groupId>org.springframework.boot</groupId>
|
|
||||||
<artifactId>spring-boot-maven-plugin</artifactId>
|
|
||||||
<configuration>
|
|
||||||
<excludes>
|
|
||||||
<exclude>
|
|
||||||
<groupId>org.projectlombok</groupId>
|
|
||||||
<artifactId>lombok</artifactId>
|
|
||||||
</exclude>
|
|
||||||
</excludes>
|
|
||||||
</configuration>
|
|
||||||
</plugin>
|
|
||||||
</plugins>
|
|
||||||
</build>
|
|
||||||
<repositories>
|
|
||||||
<repository>
|
|
||||||
<id>aliyun</id>
|
|
||||||
<name>aliyun maven</name>
|
|
||||||
<url>https://maven.aliyun.com/repository/public</url>
|
|
||||||
<releases>
|
|
||||||
<enabled>true</enabled>
|
|
||||||
</releases>
|
|
||||||
<snapshots>
|
|
||||||
<enabled>false</enabled>
|
|
||||||
</snapshots>
|
|
||||||
</repository>
|
|
||||||
</repositories>
|
|
||||||
</project>
|
|
||||||
@ -1,20 +0,0 @@
|
|||||||
package com.kama.notes;
|
|
||||||
|
|
||||||
import org.springframework.boot.SpringApplication;
|
|
||||||
import org.springframework.boot.autoconfigure.SpringBootApplication;
|
|
||||||
import org.springframework.scheduling.annotation.EnableScheduling;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName NotesApplication
|
|
||||||
* @Description ToDo
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-16 11:08
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@SpringBootApplication
|
|
||||||
@EnableScheduling
|
|
||||||
public class NotesApplication {
|
|
||||||
public static void main(String[] args) {
|
|
||||||
SpringApplication.run(NotesApplication.class, args);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,9 +0,0 @@
|
|||||||
package com.kama.notes.annotation;
|
|
||||||
|
|
||||||
import java.lang.annotation.*;
|
|
||||||
|
|
||||||
@Target({ElementType.METHOD})
|
|
||||||
@Retention(RetentionPolicy.RUNTIME)
|
|
||||||
@Documented
|
|
||||||
public @interface NeedLogin {
|
|
||||||
}
|
|
||||||
@ -1,32 +0,0 @@
|
|||||||
package com.kama.notes.aspect;
|
|
||||||
|
|
||||||
import org.aspectj.lang.ProceedingJoinPoint;
|
|
||||||
import org.aspectj.lang.annotation.Around;
|
|
||||||
import org.aspectj.lang.annotation.Aspect;
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.stereotype.Component;
|
|
||||||
|
|
||||||
import com.kama.notes.annotation.NeedLogin;
|
|
||||||
import com.kama.notes.scope.RequestScopeData;
|
|
||||||
import com.kama.notes.utils.ApiResponseUtil;
|
|
||||||
|
|
||||||
@Aspect
|
|
||||||
@Component
|
|
||||||
public class NeedLoginAspect {
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private RequestScopeData requestScopeData;
|
|
||||||
|
|
||||||
@Around("@annotation(needLogin)")
|
|
||||||
public Object around(ProceedingJoinPoint joinPoint, NeedLogin needLogin) throws Throwable {
|
|
||||||
|
|
||||||
if (!requestScopeData.isLogin()) {
|
|
||||||
return ApiResponseUtil.error("用户未登录");
|
|
||||||
}
|
|
||||||
|
|
||||||
if (requestScopeData.getUserId() == null) {
|
|
||||||
return ApiResponseUtil.error("用户 ID 异常");
|
|
||||||
}
|
|
||||||
return joinPoint.proceed();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,25 +0,0 @@
|
|||||||
package com.kama.notes.aspect;
|
|
||||||
|
|
||||||
import java.util.UUID;
|
|
||||||
|
|
||||||
import org.aspectj.lang.annotation.Aspect;
|
|
||||||
import org.aspectj.lang.annotation.Before;
|
|
||||||
import org.slf4j.MDC;
|
|
||||||
import org.springframework.stereotype.Component;
|
|
||||||
|
|
||||||
@Aspect
|
|
||||||
@Component
|
|
||||||
public class PutTraceIdAspect {
|
|
||||||
private static final String TRACE_ID_KEY = "traceId";
|
|
||||||
/**
|
|
||||||
* 切面切入点，拦截所有控制器的方法。
|
|
||||||
*/
|
|
||||||
@Before("execution(* com.kama.notes..*(..))")
|
|
||||||
public void addTraceIdToLog() {
|
|
||||||
// 如果当前 MDC 中没有 traceId，则生成一个新的
|
|
||||||
if (MDC.get(TRACE_ID_KEY) == null) {
|
|
||||||
String traceId = UUID.randomUUID().toString();
|
|
||||||
MDC.put(TRACE_ID_KEY, traceId);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,18 +0,0 @@
|
|||||||
package com.kama.notes.config;
|
|
||||||
|
|
||||||
import org.mybatis.spring.annotation.MapperScan;
|
|
||||||
import org.springframework.context.annotation.Configuration;
|
|
||||||
import org.springframework.transaction.annotation.EnableTransactionManagement;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName MyBatisConfig
|
|
||||||
* @Description MyBatis 配置类
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-17 16:22
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Configuration// 修改为正确的Mapper包路径
|
|
||||||
@MapperScan("com.kama.notes.mapper")
|
|
||||||
@EnableTransactionManagement
|
|
||||||
public class MyBatisConfig {
|
|
||||||
}
|
|
||||||
@ -1,32 +0,0 @@
|
|||||||
package com.kama.notes.config;
|
|
||||||
|
|
||||||
import org.springframework.context.annotation.Bean;
|
|
||||||
import org.springframework.context.annotation.Configuration;
|
|
||||||
import org.springframework.data.redis.core.RedisTemplate;
|
|
||||||
import org.springframework.data.redis.core.StringRedisTemplate;
|
|
||||||
import org.springframework.data.redis.connection.RedisConnectionFactory;
|
|
||||||
import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer;
|
|
||||||
import org.springframework.data.redis.serializer.StringRedisSerializer;
|
|
||||||
|
|
||||||
@Configuration
|
|
||||||
public class RedisConfig {
|
|
||||||
|
|
||||||
@Bean
|
|
||||||
public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
|
|
||||||
RedisTemplate<String, Object> template = new RedisTemplate<>();
|
|
||||||
template.setConnectionFactory(factory);
|
|
||||||
// 使用 String 序列化键（key）
|
|
||||||
template.setKeySerializer(new StringRedisSerializer());
|
|
||||||
// 使用 JSON 序列化值（value）
|
|
||||||
template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
|
|
||||||
// 使用 String 序列化哈希键（hash key）和值（hash value）
|
|
||||||
template.setHashKeySerializer(new StringRedisSerializer());
|
|
||||||
template.setHashValueSerializer(new GenericJackson2JsonRedisSerializer());
|
|
||||||
return template;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Bean
|
|
||||||
public StringRedisTemplate stringRedisTemplate(RedisConnectionFactory redisConnectionFactory) {
|
|
||||||
return new StringRedisTemplate(redisConnectionFactory);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,19 +0,0 @@
|
|||||||
package com.kama.notes.config;
|
|
||||||
|
|
||||||
import org.springframework.context.annotation.Bean;
|
|
||||||
import org.springframework.context.annotation.Configuration;
|
|
||||||
import org.springframework.scheduling.annotation.EnableScheduling;
|
|
||||||
import org.springframework.scheduling.concurrent.ThreadPoolTaskScheduler;
|
|
||||||
|
|
||||||
@Configuration
|
|
||||||
@EnableScheduling
|
|
||||||
public class SchedulerConfig {
|
|
||||||
|
|
||||||
@Bean
|
|
||||||
public ThreadPoolTaskScheduler taskScheduler() {
|
|
||||||
ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
|
|
||||||
scheduler.setPoolSize(10);
|
|
||||||
scheduler.setThreadNamePrefix("ScheduledTask-");
|
|
||||||
return scheduler;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,40 +0,0 @@
|
|||||||
package com.kama.notes.config;
|
|
||||||
|
|
||||||
import org.springframework.context.annotation.Bean;
|
|
||||||
import org.springframework.context.annotation.Configuration;
|
|
||||||
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
|
|
||||||
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
|
|
||||||
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
|
|
||||||
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
|
|
||||||
import org.springframework.security.crypto.password.PasswordEncoder;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName Security配置类
|
|
||||||
* @Description ToDo
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-17 15:40
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Configuration
|
|
||||||
@EnableWebSecurity
|
|
||||||
public class SecurityConfig extends WebSecurityConfigurerAdapter {
|
|
||||||
|
|
||||||
@Bean
|
|
||||||
public PasswordEncoder passwordEncoder() {
|
|
||||||
return new BCryptPasswordEncoder();
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
protected void configure(HttpSecurity http) throws Exception {
|
|
||||||
http.csrf()
|
|
||||||
.disable()
|
|
||||||
.authorizeRequests()
|
|
||||||
.antMatchers("/api/**", "/images/**")
|
|
||||||
.permitAll()
|
|
||||||
.anyRequest()
|
|
||||||
.authenticated()
|
|
||||||
.and()
|
|
||||||
.formLogin()
|
|
||||||
.disable();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,57 +0,0 @@
|
|||||||
package com.kama.notes.config;
|
|
||||||
|
|
||||||
import com.kama.notes.filter.TraceIdFilter;
|
|
||||||
import com.kama.notes.interceptor.TokenInterceptor;
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.beans.factory.annotation.Value;
|
|
||||||
import org.springframework.boot.web.servlet.FilterRegistrationBean;
|
|
||||||
import org.springframework.context.annotation.Bean;
|
|
||||||
import org.springframework.context.annotation.Configuration;
|
|
||||||
import org.springframework.web.servlet.config.annotation.CorsRegistry;
|
|
||||||
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
|
|
||||||
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
|
|
||||||
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
|
|
||||||
|
|
||||||
@Configuration
|
|
||||||
public class WebConfig implements WebMvcConfigurer {
|
|
||||||
|
|
||||||
@Value("${upload.path:D:/kamaNotes/upload}")
|
|
||||||
private String uploadPath;
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private TokenInterceptor tokenInterceptor;
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void addResourceHandlers(ResourceHandlerRegistry registry) {
|
|
||||||
registry.addResourceHandler("/images/**")
|
|
||||||
.addResourceLocations("file:" + uploadPath + "/");
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 添加拦截器，用于验证 token，初始化请求周期中的用户相关信息
|
|
||||||
*/
|
|
||||||
@Override
|
|
||||||
public void addInterceptors(InterceptorRegistry registry) {
|
|
||||||
registry.addInterceptor(tokenInterceptor)
|
|
||||||
.addPathPatterns("/**")
|
|
||||||
.excludePathPatterns("/login", "/error");
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void addCorsMappings(CorsRegistry registry) {
|
|
||||||
registry.addMapping("/**")
|
|
||||||
.allowedOrigins("http://localhost:5173", "http://127.0.0.1:5173") // 允许的域名
|
|
||||||
.allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS", "PATCH")// 允许的 HTTP 方法
|
|
||||||
.allowedHeaders("*")
|
|
||||||
.allowCredentials(true)
|
|
||||||
.maxAge(3600);
|
|
||||||
}
|
|
||||||
|
|
||||||
@Bean
|
|
||||||
public FilterRegistrationBean<TraceIdFilter> traceIdFilter() {
|
|
||||||
FilterRegistrationBean<TraceIdFilter> registrationBean = new FilterRegistrationBean<>();
|
|
||||||
registrationBean.setFilter(new TraceIdFilter());
|
|
||||||
registrationBean.addUrlPatterns("/*");
|
|
||||||
return registrationBean;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,90 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import javax.validation.Valid;
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.DeleteMapping;
|
|
||||||
import org.springframework.web.bind.annotation.GetMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PatchMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PathVariable;
|
|
||||||
import org.springframework.web.bind.annotation.PostMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestBody;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.base.EmptyVO;
|
|
||||||
import com.kama.notes.model.dto.category.CreateCategoryBody;
|
|
||||||
import com.kama.notes.model.dto.category.UpdateCategoryBody;
|
|
||||||
import com.kama.notes.model.vo.category.CategoryVO;
|
|
||||||
import com.kama.notes.model.vo.category.CreateCategoryVO;
|
|
||||||
import com.kama.notes.service.CategoryService;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class CategoryController {
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private CategoryService categoryService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取分类列表（用户端）。
|
|
||||||
*
|
|
||||||
* @return 包含分类列表的响应。
|
|
||||||
*/
|
|
||||||
@GetMapping("/categories")
|
|
||||||
public ApiResponse<List<CategoryVO>> userCategories() {
|
|
||||||
return categoryService.categoryList();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取分类列表（管理员端）。
|
|
||||||
*
|
|
||||||
* @return 包含分类列表的响应。
|
|
||||||
*/
|
|
||||||
@GetMapping("/admin/categories")
|
|
||||||
public ApiResponse<List<CategoryVO>> categories() {
|
|
||||||
return categoryService.categoryList();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 创建新的分类。
|
|
||||||
*
|
|
||||||
* @param createCategoryBody 包含分类创建信息的请求体。
|
|
||||||
* @return 包含创建成功的分类信息的响应。
|
|
||||||
*/
|
|
||||||
@PostMapping("/admin/categories")
|
|
||||||
public ApiResponse<CreateCategoryVO> createCategory(
|
|
||||||
@Valid @RequestBody CreateCategoryBody createCategoryBody) {
|
|
||||||
return categoryService.createCategory(createCategoryBody);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新指定的分类信息。
|
|
||||||
*
|
|
||||||
* @param categoryId 分类ID，必须为正整数。
|
|
||||||
* @param updateCategoryBody 包含更新信息的请求体。
|
|
||||||
* @return 包含更新操作结果的响应。
|
|
||||||
*/
|
|
||||||
@PatchMapping("/admin/categories/{categoryId}")
|
|
||||||
public ApiResponse<EmptyVO> updateCategory(
|
|
||||||
@Min(value = 1, message = "categoryId 必须为正整数") @PathVariable Integer categoryId,
|
|
||||||
@Valid @RequestBody UpdateCategoryBody updateCategoryBody) {
|
|
||||||
return categoryService.updateCategory(categoryId, updateCategoryBody);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除指定的分类。
|
|
||||||
*
|
|
||||||
* @param categoryId 分类ID，必须为正整数。
|
|
||||||
* @return 包含删除操作结果的响应。
|
|
||||||
*/
|
|
||||||
@DeleteMapping("/admin/categories/{categoryId}")
|
|
||||||
public ApiResponse<EmptyVO> deleteCategory(
|
|
||||||
@Min(value = 1, message = "categoryId 必须为正整数") @PathVariable Integer categoryId) {
|
|
||||||
return categoryService.deleteCategory(categoryId);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,87 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import javax.validation.Valid;
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.DeleteMapping;
|
|
||||||
import org.springframework.web.bind.annotation.GetMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PathVariable;
|
|
||||||
import org.springframework.web.bind.annotation.PostMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestBody;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.base.EmptyVO;
|
|
||||||
import com.kama.notes.model.dto.collection.CollectionQueryParams;
|
|
||||||
import com.kama.notes.model.dto.collection.CreateCollectionBody;
|
|
||||||
import com.kama.notes.model.dto.collection.UpdateCollectionBody;
|
|
||||||
import com.kama.notes.model.vo.collection.CollectionVO;
|
|
||||||
import com.kama.notes.model.vo.collection.CreateCollectionVO;
|
|
||||||
import com.kama.notes.service.CollectionService;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class CollectionController {
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private CollectionService collectionService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取收藏夹列表接口
|
|
||||||
*
|
|
||||||
* @param queryParams 查询参数
|
|
||||||
* @return 收藏夹列表
|
|
||||||
*/
|
|
||||||
@GetMapping("/collections")
|
|
||||||
public ApiResponse<List<CollectionVO>> getCollections(
|
|
||||||
@Valid
|
|
||||||
CollectionQueryParams queryParams) {
|
|
||||||
return collectionService.getCollections(queryParams);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 创建收藏夹接口
|
|
||||||
*
|
|
||||||
* @param requestBody 创建收藏夹请求体
|
|
||||||
* @return 创建结果，如果成功则包含收藏夹 ID
|
|
||||||
*/
|
|
||||||
@PostMapping("/collections")
|
|
||||||
public ApiResponse<CreateCollectionVO> createCollection(
|
|
||||||
@Valid
|
|
||||||
@RequestBody
|
|
||||||
CreateCollectionBody requestBody) {
|
|
||||||
return collectionService.createCollection(requestBody);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除收藏夹接口
|
|
||||||
*
|
|
||||||
* @param collectionId 收藏夹 ID
|
|
||||||
* @return 返回删除结果
|
|
||||||
*/
|
|
||||||
@DeleteMapping("/collections/{collectionId}")
|
|
||||||
public ApiResponse<EmptyVO> deleteCollection(
|
|
||||||
@PathVariable
|
|
||||||
@Min(value = 1, message = "collectionId 必须为正整数")
|
|
||||||
Integer collectionId) {
|
|
||||||
return collectionService.deleteCollection(collectionId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量修改收藏夹接口
|
|
||||||
*
|
|
||||||
* @param collectionBody 收藏夹 ID
|
|
||||||
* @return 返回修改结果
|
|
||||||
*/
|
|
||||||
@PostMapping("/collections/batch")
|
|
||||||
public ApiResponse<EmptyVO> batchModifyCollection(
|
|
||||||
@Valid
|
|
||||||
@RequestBody
|
|
||||||
UpdateCollectionBody collectionBody) {
|
|
||||||
return collectionService.batchModifyCollection(collectionBody);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,9 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class CollectionNoteController {
|
|
||||||
}
|
|
||||||
@ -1,128 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import javax.validation.Valid;
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.DeleteMapping;
|
|
||||||
import org.springframework.web.bind.annotation.GetMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PatchMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PathVariable;
|
|
||||||
import org.springframework.web.bind.annotation.PostMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestBody;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.base.EmptyVO;
|
|
||||||
import com.kama.notes.model.dto.note.CreateNoteRequest;
|
|
||||||
import com.kama.notes.model.dto.note.NoteQueryParams;
|
|
||||||
import com.kama.notes.model.dto.note.UpdateNoteRequest;
|
|
||||||
import com.kama.notes.model.vo.note.CreateNoteVO;
|
|
||||||
import com.kama.notes.model.vo.note.DownloadNoteVO;
|
|
||||||
import com.kama.notes.model.vo.note.NoteHeatMapItem;
|
|
||||||
import com.kama.notes.model.vo.note.NoteRankListItem;
|
|
||||||
import com.kama.notes.model.vo.note.NoteVO;
|
|
||||||
import com.kama.notes.model.vo.note.Top3Count;
|
|
||||||
import com.kama.notes.service.NoteService;
|
|
||||||
|
|
||||||
import lombok.extern.log4j.Log4j2;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 笔记控制器
|
|
||||||
*/
|
|
||||||
@Log4j2
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class NoteController {
|
|
||||||
|
|
||||||
// 自动注入 NoteService 实例，用于处理笔记相关的业务逻辑
|
|
||||||
@Autowired
|
|
||||||
private NoteService noteService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询笔记列表
|
|
||||||
*
|
|
||||||
* @param params 查询参数对象，包含筛选条件
|
|
||||||
* @return 返回一个包含笔记列表的 ApiResponse 对象
|
|
||||||
*/
|
|
||||||
@GetMapping("/notes")
|
|
||||||
public ApiResponse<List<NoteVO>> getNotes(
|
|
||||||
@Valid NoteQueryParams params) {
|
|
||||||
return noteService.getNotes(params);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 发布笔记
|
|
||||||
*
|
|
||||||
* @param request 创建笔记的请求对象，包含笔记的内容等信息
|
|
||||||
* @return 返回一个包含新创建笔记信息的 ApiResponse 对象
|
|
||||||
*/
|
|
||||||
@PostMapping("/notes")
|
|
||||||
public ApiResponse<CreateNoteVO> createNote(
|
|
||||||
@Valid @RequestBody CreateNoteRequest request) {
|
|
||||||
return noteService.createNote(request);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新笔记
|
|
||||||
*
|
|
||||||
* @param noteId 笔记的唯一标识符，用于定位要更新的笔记
|
|
||||||
* @param request 更新笔记的请求对象，包含需要修改的信息
|
|
||||||
* @return 返回一个包含更新后笔记信息的 ApiResponse 对象
|
|
||||||
*/
|
|
||||||
@PatchMapping("/notes/{noteId}")
|
|
||||||
public ApiResponse<EmptyVO> updateNote(
|
|
||||||
@Min(value = 1, message = "noteId 必须为正整数") @PathVariable Integer noteId,
|
|
||||||
@Valid @RequestBody UpdateNoteRequest request) {
|
|
||||||
return noteService.updateNote(noteId, request);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除笔记
|
|
||||||
*
|
|
||||||
* @param noteId 笔记的唯一标识符，用于定位要删除的笔记
|
|
||||||
* @return 返回一个包含删除结果信息的 ApiResponse 对象
|
|
||||||
*/
|
|
||||||
@DeleteMapping("/notes/{noteId}")
|
|
||||||
public ApiResponse<EmptyVO> deleteNote(
|
|
||||||
@Min(value = 1, message = "noteId 必须为正整数")
|
|
||||||
@PathVariable Integer noteId) {
|
|
||||||
return noteService.deleteNote(noteId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 下载笔记
|
|
||||||
* @return
|
|
||||||
*/
|
|
||||||
@GetMapping("/notes/download")
|
|
||||||
public ApiResponse<DownloadNoteVO> downloadNote() {
|
|
||||||
return noteService.downloadNote();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 提交笔记排行榜
|
|
||||||
*/
|
|
||||||
@GetMapping("/notes/ranklist")
|
|
||||||
public ApiResponse<List<NoteRankListItem>> submitNoteRank() {
|
|
||||||
return noteService.submitNoteRank();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户提交热力图
|
|
||||||
*/
|
|
||||||
@GetMapping("/notes/heatmap")
|
|
||||||
public ApiResponse<List<NoteHeatMapItem>> submitNoteHeatMap() {
|
|
||||||
return noteService.submitNoteHeatMap();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户提交 top3 count
|
|
||||||
*/
|
|
||||||
@GetMapping("/notes/top3count")
|
|
||||||
public ApiResponse<Top3Count> submitNoteTop3Count() {
|
|
||||||
return noteService.submitNoteTop3Count();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,29 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.DeleteMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PathVariable;
|
|
||||||
import org.springframework.web.bind.annotation.PostMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.base.EmptyVO;
|
|
||||||
import com.kama.notes.service.NoteLikeService;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class NoteLikeController {
|
|
||||||
@Autowired
|
|
||||||
private NoteLikeService noteLikeService;
|
|
||||||
|
|
||||||
@PostMapping("/like/note/{noteId}")
|
|
||||||
public ApiResponse<EmptyVO> likeNote(@PathVariable Integer noteId) {
|
|
||||||
return noteLikeService.likeNote(noteId);
|
|
||||||
}
|
|
||||||
|
|
||||||
@DeleteMapping("/like/note/{noteId}")
|
|
||||||
public ApiResponse<EmptyVO> unlikeNote(@PathVariable Integer noteId) {
|
|
||||||
return noteLikeService.unlikeNote(noteId);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,41 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import javax.validation.Valid;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.GetMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PostMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestBody;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.base.EmptyVO;
|
|
||||||
import com.kama.notes.model.dto.notification.NotificationDTO;
|
|
||||||
import com.kama.notes.model.vo.notification.NotificationVO;
|
|
||||||
import com.kama.notes.service.RedisService;
|
|
||||||
import com.kama.notes.utils.ApiResponseUtil;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class NotificationController {
|
|
||||||
|
|
||||||
// 由于比较简单，直接全写在 controller 内了，免得出现透传
|
|
||||||
@Autowired
|
|
||||||
private RedisService redisService;
|
|
||||||
|
|
||||||
@GetMapping("/notification")
|
|
||||||
public ApiResponse<NotificationVO> getNotifications() {
|
|
||||||
NotificationVO notificationVO = new NotificationVO();
|
|
||||||
Object o = redisService.get("kamanote:notification");
|
|
||||||
String content = o == null ? "" : o.toString();
|
|
||||||
notificationVO.setContent(content);
|
|
||||||
return ApiResponseUtil.success("获取通知成功", notificationVO);
|
|
||||||
}
|
|
||||||
|
|
||||||
@PostMapping("/notification")
|
|
||||||
public ApiResponse<EmptyVO> setNotifications(@Valid @RequestBody NotificationDTO notificationDTO) {
|
|
||||||
redisService.set("kamanote:notification", notificationDTO.getContent());
|
|
||||||
return ApiResponseUtil.success("设置通知成功");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,118 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import javax.validation.Valid;
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.DeleteMapping;
|
|
||||||
import org.springframework.web.bind.annotation.GetMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PatchMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PathVariable;
|
|
||||||
import org.springframework.web.bind.annotation.PostMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestBody;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.base.EmptyVO;
|
|
||||||
import com.kama.notes.model.dto.question.CreateQuestionBody;
|
|
||||||
import com.kama.notes.model.dto.question.QuestionQueryParam;
|
|
||||||
import com.kama.notes.model.dto.question.SearchQuestionBody;
|
|
||||||
import com.kama.notes.model.dto.question.UpdateQuestionBody;
|
|
||||||
import com.kama.notes.model.vo.question.CreateQuestionVO;
|
|
||||||
import com.kama.notes.model.vo.question.QuestionNoteVO;
|
|
||||||
import com.kama.notes.model.vo.question.QuestionUserVO;
|
|
||||||
import com.kama.notes.model.vo.question.QuestionVO;
|
|
||||||
import com.kama.notes.service.QuestionService;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class QuestionController {
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private QuestionService questionService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户端获取问题列表
|
|
||||||
*
|
|
||||||
* @param queryParams 查询参数，用于过滤问题列表（如关键词、分类等）
|
|
||||||
* @return 包含用户可见问题的视图对象列表的响应
|
|
||||||
*/
|
|
||||||
@GetMapping("/questions")
|
|
||||||
public ApiResponse<List<QuestionUserVO>> userGetQuestions(@Valid QuestionQueryParam queryParams) {
|
|
||||||
return questionService.userGetQuestions(queryParams);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户端搜索问题
|
|
||||||
*
|
|
||||||
* @param body 包含搜索关键词的请求体
|
|
||||||
* @return 包含搜索结果的视图对象列表的响应
|
|
||||||
*/
|
|
||||||
@PostMapping("/questions/search")
|
|
||||||
public ApiResponse<List<QuestionVO>> searchQuestions(@Valid @RequestBody SearchQuestionBody body) {
|
|
||||||
return questionService.searchQuestions(body);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户端获取单个问题详情
|
|
||||||
*
|
|
||||||
* @param questionId 问题ID，必须为正整数
|
|
||||||
* @return 包含问题详情及关联笔记的视图对象的响应
|
|
||||||
*/
|
|
||||||
@GetMapping("/questions/{questionId}")
|
|
||||||
public ApiResponse<QuestionNoteVO> userGetQuestion(@Min(value = 1, message = "questionId 必须为正整数")
|
|
||||||
@PathVariable Integer questionId) {
|
|
||||||
return questionService.userGetQuestion(questionId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 管理端获取问题列表
|
|
||||||
*
|
|
||||||
* @param queryParams 查询参数，用于过滤问题列表（如关键词、时间范围等）
|
|
||||||
* @return 包含所有问题的视图对象列表的响应
|
|
||||||
*/
|
|
||||||
@GetMapping("/admin/questions")
|
|
||||||
public ApiResponse<List<QuestionVO>> getQuestions(@Valid QuestionQueryParam queryParams) {
|
|
||||||
return questionService.getQuestions(queryParams);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 管理端创建新问题
|
|
||||||
*
|
|
||||||
* @param createQuestionBody 创建问题的请求体，包含问题的标题、内容等信息
|
|
||||||
* @return 包含新创建问题视图对象的响应
|
|
||||||
*/
|
|
||||||
@PostMapping("/admin/questions")
|
|
||||||
public ApiResponse<CreateQuestionVO> createQuestion(@Valid @RequestBody CreateQuestionBody createQuestionBody) {
|
|
||||||
return questionService.createQuestion(createQuestionBody);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 管理端更新问题
|
|
||||||
*
|
|
||||||
* @param questionId 问题ID，必须为正整数
|
|
||||||
* @param updateQuestionBody 更新问题的请求体，包含要更新的字段和值
|
|
||||||
* @return 空视图对象的响应，表示更新操作成功
|
|
||||||
*/
|
|
||||||
@PatchMapping("/admin/questions/{questionId}")
|
|
||||||
public ApiResponse<EmptyVO> updateQuestion(@Min(value = 1, message = "questionId 必须为正整数")
|
|
||||||
@PathVariable Integer questionId,
|
|
||||||
@Valid @RequestBody UpdateQuestionBody updateQuestionBody) {
|
|
||||||
return questionService.updateQuestion(questionId, updateQuestionBody);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 管理端删除问题
|
|
||||||
*
|
|
||||||
* @param questionId 问题ID，必须为正整数
|
|
||||||
* @return 空视图对象的响应，表示删除操作成功
|
|
||||||
*/
|
|
||||||
@DeleteMapping("/admin/questions/{questionId}")
|
|
||||||
public ApiResponse<EmptyVO> deleteQuestion(@Min(value = 1, message = "questionId 必须为正整数")
|
|
||||||
@PathVariable Integer questionId) {
|
|
||||||
return questionService.deleteQuestion(questionId);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,90 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import javax.validation.Valid;
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.DeleteMapping;
|
|
||||||
import org.springframework.web.bind.annotation.GetMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PatchMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PathVariable;
|
|
||||||
import org.springframework.web.bind.annotation.PostMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestBody;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.base.EmptyVO;
|
|
||||||
import com.kama.notes.model.dto.questionList.CreateQuestionListBody;
|
|
||||||
import com.kama.notes.model.dto.questionList.UpdateQuestionListBody;
|
|
||||||
import com.kama.notes.model.entity.QuestionList;
|
|
||||||
import com.kama.notes.model.vo.questionList.CreateQuestionListVO;
|
|
||||||
import com.kama.notes.service.QuestionListService;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class QuestionListController {
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private QuestionListService questionListService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取题单。
|
|
||||||
*
|
|
||||||
* @return 包含题单列表的响应。
|
|
||||||
*/
|
|
||||||
@GetMapping("/admin/questionlists/{questionListId}")
|
|
||||||
public ApiResponse<QuestionList> getQuestionList(@Min(value = 1, message = "questionListId 必须为正整数")
|
|
||||||
@PathVariable Integer questionListId) {
|
|
||||||
return questionListService.getQuestionList(questionListId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取题单列表。
|
|
||||||
*
|
|
||||||
* @return 包含题单列表的响应。
|
|
||||||
*/
|
|
||||||
@GetMapping("/admin/questionlists")
|
|
||||||
public ApiResponse<List<QuestionList>> getQuestionLists() {
|
|
||||||
return questionListService.getQuestionLists();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 创建新的题单。
|
|
||||||
*
|
|
||||||
* @param body 包含题单创建信息的请求体。
|
|
||||||
* @return 包含创建成功的题单信息的响应。
|
|
||||||
*/
|
|
||||||
@PostMapping("/admin/questionlists")
|
|
||||||
public ApiResponse<CreateQuestionListVO> createQuestionList(@Valid @RequestBody CreateQuestionListBody body) {
|
|
||||||
return questionListService.createQuestionList(body);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除指定的题单。
|
|
||||||
*
|
|
||||||
* @param questionListId 要删除的题单ID，必须为正整数。
|
|
||||||
* @return 包含删除操作结果的响应。
|
|
||||||
*/
|
|
||||||
@DeleteMapping("/admin/questionlists/{questionListId}")
|
|
||||||
public ApiResponse<EmptyVO> deleteQuestionList(@Min(value = 1, message = "questionListId 必须为正整数")
|
|
||||||
@PathVariable Integer questionListId) {
|
|
||||||
return questionListService.deleteQuestionList(questionListId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新指定的题单信息。
|
|
||||||
*
|
|
||||||
* @param questionListId 要更新的题单ID，必须为正整数。
|
|
||||||
* @param body 包含更新信息的请求体。
|
|
||||||
* @return 包含更新操作结果的响应。
|
|
||||||
*/
|
|
||||||
@PatchMapping("/admin/questionlists/{questionListId}")
|
|
||||||
public ApiResponse<EmptyVO> updateQuestionList(@Min(value = 1, message = "questionListId 必须为正整数")
|
|
||||||
@PathVariable Integer questionListId,
|
|
||||||
@Valid @RequestBody UpdateQuestionListBody body) {
|
|
||||||
return questionListService.updateQuestionList(questionListId, body);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,94 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.base.EmptyVO;
|
|
||||||
import com.kama.notes.model.dto.questionListItem.CreateQuestionListItemBody;
|
|
||||||
import com.kama.notes.model.dto.questionListItem.QuestionListItemQueryParams;
|
|
||||||
import com.kama.notes.model.dto.questionListItem.SortQuestionListItemBody;
|
|
||||||
import com.kama.notes.model.vo.questionListItem.CreateQuestionListItemVO;
|
|
||||||
import com.kama.notes.model.vo.questionListItem.QuestionListItemUserVO;
|
|
||||||
import com.kama.notes.model.vo.questionListItem.QuestionListItemVO;
|
|
||||||
import com.kama.notes.service.QuestionListItemService;
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.*;
|
|
||||||
|
|
||||||
import javax.validation.Valid;
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class QuestionListItemController {
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private QuestionListItemService questionListItemService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取指定题单中的题单项列表（用户端）。
|
|
||||||
*
|
|
||||||
* @param queryParams 查询参数
|
|
||||||
* @return 包含题单项列表的响应。
|
|
||||||
*/
|
|
||||||
@GetMapping("/questionlist-items")
|
|
||||||
public ApiResponse<List<QuestionListItemUserVO>> userGetQuestionListItems(
|
|
||||||
@Valid QuestionListItemQueryParams queryParams) {
|
|
||||||
return questionListItemService.userGetQuestionListItems(queryParams);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取指定题单中的题单项列表（管理端）。
|
|
||||||
*
|
|
||||||
* @param questionListId 题单ID，可选参数，若提供则获取指定题单的题单项。
|
|
||||||
* @return 包含题单项列表的响应。
|
|
||||||
*/
|
|
||||||
@GetMapping("/admin/questionlist-items/{questionListId}")
|
|
||||||
public ApiResponse<List<QuestionListItemVO>> getQuestionListItems(
|
|
||||||
@Min(value = 1, message = "questionListId 必须为正整数")
|
|
||||||
@PathVariable Integer questionListId) {
|
|
||||||
return questionListItemService.getQuestionListItems(questionListId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 创建新的题单项。
|
|
||||||
*
|
|
||||||
* @param body 包含题单项创建信息的请求体。
|
|
||||||
* @return 包含创建成功的题单项信息的响应。
|
|
||||||
*/
|
|
||||||
@PostMapping("/admin/questionlist-items")
|
|
||||||
public ApiResponse<CreateQuestionListItemVO> createQuestionListItem(
|
|
||||||
@Valid
|
|
||||||
@RequestBody
|
|
||||||
CreateQuestionListItemBody body) {
|
|
||||||
return questionListItemService.createQuestionListItem(body);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除指定的题单项。
|
|
||||||
*
|
|
||||||
* @param questionListId 题单ID，必须为正整数。
|
|
||||||
* @param questionId 题目ID，必须为正整数。
|
|
||||||
* @return 包含删除操作结果的响应。
|
|
||||||
*/
|
|
||||||
@DeleteMapping("/admin/questionlist-items/{questionListId}/{questionId}")
|
|
||||||
public ApiResponse<EmptyVO> deleteQuestionListItem(
|
|
||||||
@Min(value = 1, message = "questionListId 必须为正整数")
|
|
||||||
@PathVariable Integer questionListId,
|
|
||||||
@Min(value = 1, message = "questionId 必须为正整数")
|
|
||||||
@PathVariable Integer questionId) {
|
|
||||||
return questionListItemService.deleteQuestionListItem(questionListId, questionId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新题单项的排序。
|
|
||||||
*
|
|
||||||
* @param body 包含题单项排序信息的请求体。
|
|
||||||
* @return 包含更新操作结果的响应。
|
|
||||||
*/
|
|
||||||
@PatchMapping("/admin/questionlist-items/sort")
|
|
||||||
public ApiResponse<EmptyVO> sortQuestionListItem(
|
|
||||||
@Valid
|
|
||||||
@RequestBody
|
|
||||||
SortQuestionListItemBody body) {
|
|
||||||
return questionListItemService.sortQuestionListItem(body);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,28 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import javax.validation.Valid;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.GetMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.dto.statistic.StatisticQueryParam;
|
|
||||||
import com.kama.notes.model.entity.Statistic;
|
|
||||||
import com.kama.notes.service.StatisticService;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class StatisticController {
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
StatisticService statisticService;
|
|
||||||
|
|
||||||
@GetMapping("/statistic")
|
|
||||||
public ApiResponse<List<Statistic>> getStatistic(@Valid StatisticQueryParam queryParam) {
|
|
||||||
return statisticService.getStatistic(queryParam);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,29 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import com.kama.notes.scope.RequestScopeData;
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.GetMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class TestController {
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private RequestScopeData requestScopeData;
|
|
||||||
|
|
||||||
@GetMapping("/hello")
|
|
||||||
public String hello() {
|
|
||||||
|
|
||||||
System.out.println("get data in /test/hello");
|
|
||||||
System.out.println(requestScopeData.getUserId());
|
|
||||||
System.out.println(requestScopeData.getToken());
|
|
||||||
return "Hello World!";
|
|
||||||
}
|
|
||||||
|
|
||||||
@GetMapping("/exception")
|
|
||||||
public String exception() {
|
|
||||||
throw new RuntimeException("test exception");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,31 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.PostMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestParam;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
import org.springframework.web.multipart.MultipartFile;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.vo.upload.ImageVO;
|
|
||||||
import com.kama.notes.service.UploadService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 文件上传控制器
|
|
||||||
*/
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class UploadController {
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private UploadService uploadService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 上传图片
|
|
||||||
*/
|
|
||||||
@PostMapping("/upload/image")
|
|
||||||
public ApiResponse<ImageVO> uploadImage(@RequestParam("file") MultipartFile file) {
|
|
||||||
return uploadService.uploadImage(file);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,137 +0,0 @@
|
|||||||
package com.kama.notes.controller;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import javax.validation.Valid;
|
|
||||||
import javax.validation.constraints.Pattern;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.web.bind.annotation.GetMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PatchMapping;
|
|
||||||
import org.springframework.web.bind.annotation.PathVariable;
|
|
||||||
import org.springframework.web.bind.annotation.PostMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestBody;
|
|
||||||
import org.springframework.web.bind.annotation.RequestMapping;
|
|
||||||
import org.springframework.web.bind.annotation.RequestParam;
|
|
||||||
import org.springframework.web.bind.annotation.RestController;
|
|
||||||
import org.springframework.web.multipart.MultipartFile;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import com.kama.notes.model.dto.user.LoginRequest;
|
|
||||||
import com.kama.notes.model.dto.user.RegisterRequest;
|
|
||||||
import com.kama.notes.model.dto.user.UpdateUserRequest;
|
|
||||||
import com.kama.notes.model.dto.user.UserQueryParam;
|
|
||||||
import com.kama.notes.model.entity.User;
|
|
||||||
import com.kama.notes.model.vo.user.AvatarVO;
|
|
||||||
import com.kama.notes.model.vo.user.LoginUserVO;
|
|
||||||
import com.kama.notes.model.vo.user.RegisterVO;
|
|
||||||
import com.kama.notes.model.vo.user.UserVO;
|
|
||||||
import com.kama.notes.service.UserService;
|
|
||||||
|
|
||||||
import lombok.extern.slf4j.Slf4j;
|
|
||||||
|
|
||||||
@Slf4j
|
|
||||||
@RestController
|
|
||||||
@RequestMapping("/api")
|
|
||||||
public class UserController {
|
|
||||||
|
|
||||||
// 自动注入UserService以使用用户相关服务
|
|
||||||
@Autowired
|
|
||||||
private UserService userService;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户注册接口
|
|
||||||
* 处理用户注册请求，验证请求体并调用 userService 进行注册
|
|
||||||
*
|
|
||||||
* @param request 用户注册请求对象，包含用户注册所需信息
|
|
||||||
* @return 返回注册结果，包括用户信息等
|
|
||||||
*/
|
|
||||||
@PostMapping("/users")
|
|
||||||
public ApiResponse<RegisterVO> register(
|
|
||||||
@Valid
|
|
||||||
@RequestBody
|
|
||||||
RegisterRequest request) {
|
|
||||||
return userService.register(request);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户登录接口
|
|
||||||
* 处理用户登录请求，验证请求体并调用userService进行登录
|
|
||||||
*
|
|
||||||
* @param request 用户登录请求对象，包含用户登录所需信息
|
|
||||||
* @return 返回登录结果，包括用户信息和认证令牌等
|
|
||||||
*/
|
|
||||||
@PostMapping("/users/login")
|
|
||||||
public ApiResponse<LoginUserVO> login(
|
|
||||||
@Valid
|
|
||||||
@RequestBody
|
|
||||||
LoginRequest request) {
|
|
||||||
return userService.login(request);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 自动登录接口
|
|
||||||
* 当用户已登录并请求自动登录时，调用userService获取当前用户信息
|
|
||||||
*
|
|
||||||
* @return 返回当前用户信息
|
|
||||||
*/
|
|
||||||
@PostMapping("/users/whoami")
|
|
||||||
public ApiResponse<LoginUserVO> whoami() {
|
|
||||||
return userService.whoami();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询用户信息接口
|
|
||||||
* 根据用户ID查询用户信息，验证ID格式并调用userService获取用户详情
|
|
||||||
*
|
|
||||||
* @param userId 用户ID，需为数字格式
|
|
||||||
* @return 返回指定用户的详细信息
|
|
||||||
*/
|
|
||||||
@GetMapping("/users/{userId}")
|
|
||||||
public ApiResponse<UserVO> getUserInfo(
|
|
||||||
@PathVariable
|
|
||||||
@Pattern(regexp = "\\d+", message = "ID 格式错误")
|
|
||||||
Long userId) {
|
|
||||||
return userService.getUserInfo(userId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新用户信息接口
|
|
||||||
* 处理更新用户信息请求，验证请求体并调用userService更新用户详情
|
|
||||||
*
|
|
||||||
* @param request 更新用户请求对象，包含需要更新的用户信息
|
|
||||||
* @return 返回更新后的用户信息
|
|
||||||
*/
|
|
||||||
@PatchMapping("/users/me")
|
|
||||||
public ApiResponse<LoginUserVO> updateUserInfo(
|
|
||||||
@Valid
|
|
||||||
@RequestBody
|
|
||||||
UpdateUserRequest request) {
|
|
||||||
return userService.updateUserInfo(request);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 上传用户头像接口
|
|
||||||
*
|
|
||||||
* @param file 头像文件
|
|
||||||
* @return 返回上传结果，包括头像URL等
|
|
||||||
*/
|
|
||||||
@PostMapping("/users/avatar")
|
|
||||||
public ApiResponse<AvatarVO> uploadAvatar(
|
|
||||||
@RequestParam("file") MultipartFile file) {
|
|
||||||
return userService.uploadAvatar(file);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 管理员获取用户信息列表的接口
|
|
||||||
* 该接口允许管理员查询系统的用户列表，支持分页和条件查询
|
|
||||||
*
|
|
||||||
* @param queryParam 查询参数对象，封装了用户查询条件和分页信息，通过验证确保参数有效性
|
|
||||||
* @return 返回一个包含用户列表的ApiResponse对象，响应中包含用户数据
|
|
||||||
*/
|
|
||||||
@GetMapping("/admin/users")
|
|
||||||
public ApiResponse<List<User>> adminGetUser(
|
|
||||||
@Valid UserQueryParam queryParam) {
|
|
||||||
return userService.getUserList(queryParam);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,38 +0,0 @@
|
|||||||
package com.kama.notes.exception;
|
|
||||||
|
|
||||||
import com.kama.notes.model.base.ApiResponse;
|
|
||||||
import org.springframework.http.HttpStatus;
|
|
||||||
import org.springframework.web.bind.MethodArgumentNotValidException;
|
|
||||||
import org.springframework.web.bind.annotation.ExceptionHandler;
|
|
||||||
import org.springframework.web.bind.annotation.RestControllerAdvice;
|
|
||||||
|
|
||||||
import javax.validation.ConstraintViolationException;
|
|
||||||
import java.util.HashMap;
|
|
||||||
import java.util.Map;
|
|
||||||
|
|
||||||
@RestControllerAdvice
|
|
||||||
public class ParamExceptionHandler {
|
|
||||||
|
|
||||||
@ExceptionHandler(MethodArgumentNotValidException.class)
|
|
||||||
public ApiResponse<Map<String, String>> handleValidationExceptions(MethodArgumentNotValidException ex) {
|
|
||||||
Map<String, String> errors = new HashMap<>();
|
|
||||||
ex.getBindingResult().getFieldErrors().forEach(error ->
|
|
||||||
errors.put(error.getField(), error.getDefaultMessage())
|
|
||||||
);
|
|
||||||
return new ApiResponse<>(HttpStatus.BAD_REQUEST.value(), "Validation Failed", errors);
|
|
||||||
}
|
|
||||||
|
|
||||||
@ExceptionHandler(ConstraintViolationException.class)
|
|
||||||
public ApiResponse<Map<String, String>> handleConstraintViolationExceptions(ConstraintViolationException ex) {
|
|
||||||
Map<String, String> errors = new HashMap<>();
|
|
||||||
ex.getConstraintViolations().forEach(violation ->
|
|
||||||
errors.put(violation.getPropertyPath().toString(), violation.getMessage())
|
|
||||||
);
|
|
||||||
return new ApiResponse<>(HttpStatus.BAD_REQUEST.value(), "Validation Failed", errors);
|
|
||||||
}
|
|
||||||
|
|
||||||
@ExceptionHandler(Exception.class)
|
|
||||||
public ApiResponse<String> handleException(Exception ex) {
|
|
||||||
return new ApiResponse<>(HttpStatus.INTERNAL_SERVER_ERROR.value(), "Internal Server Error", ex.getMessage());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,33 +0,0 @@
|
|||||||
package com.kama.notes.filter;
|
|
||||||
|
|
||||||
import org.slf4j.MDC;
|
|
||||||
|
|
||||||
import javax.servlet.Filter;
|
|
||||||
import javax.servlet.FilterChain;
|
|
||||||
import javax.servlet.FilterConfig;
|
|
||||||
import javax.servlet.ServletException;
|
|
||||||
import javax.servlet.ServletRequest;
|
|
||||||
import javax.servlet.ServletResponse;
|
|
||||||
import java.io.IOException;
|
|
||||||
|
|
||||||
public class TraceIdFilter implements Filter {
|
|
||||||
|
|
||||||
private static final String TRACE_ID_KEY = "traceId";
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
|
|
||||||
throws IOException, ServletException {
|
|
||||||
try {
|
|
||||||
chain.doFilter(request, response);
|
|
||||||
} finally {
|
|
||||||
// 清理 MDC 中的 traceId
|
|
||||||
MDC.remove(TRACE_ID_KEY);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void init(FilterConfig filterConfig) throws ServletException {}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void destroy() {}
|
|
||||||
}
|
|
||||||
@ -1,49 +0,0 @@
|
|||||||
package com.kama.notes.interceptor;
|
|
||||||
|
|
||||||
import javax.servlet.http.HttpServletRequest;
|
|
||||||
import javax.servlet.http.HttpServletResponse;
|
|
||||||
|
|
||||||
import org.springframework.beans.factory.annotation.Autowired;
|
|
||||||
import org.springframework.stereotype.Component;
|
|
||||||
import org.springframework.web.servlet.HandlerInterceptor;
|
|
||||||
|
|
||||||
import com.kama.notes.scope.RequestScopeData;
|
|
||||||
import com.kama.notes.utils.JwtUtil;
|
|
||||||
|
|
||||||
@Component
|
|
||||||
public class TokenInterceptor implements HandlerInterceptor
|
|
||||||
{
|
|
||||||
@Autowired
|
|
||||||
private RequestScopeData requestScopeData;
|
|
||||||
|
|
||||||
@Autowired
|
|
||||||
private JwtUtil jwtUtil;
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
|
|
||||||
|
|
||||||
// 对于每个请求进行拦截，获取请求头中的 token
|
|
||||||
// 然后对 token 进行处理，并将 token 携带的信息存储到，在请求周期中全局存在的 requestScopeData 中
|
|
||||||
|
|
||||||
String token = request.getHeader("Authorization");
|
|
||||||
|
|
||||||
if (token == null) {
|
|
||||||
requestScopeData.setLogin(false);
|
|
||||||
requestScopeData.setToken(null);
|
|
||||||
requestScopeData.setUserId(null);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
token = token.replace("Bearer ", "");
|
|
||||||
|
|
||||||
if (jwtUtil.validateToken(token)) {
|
|
||||||
Long userId = jwtUtil.getUserIdFromToken(token);
|
|
||||||
requestScopeData.setUserId(userId);
|
|
||||||
requestScopeData.setToken(token);
|
|
||||||
requestScopeData.setLogin(true);
|
|
||||||
} else {
|
|
||||||
requestScopeData.setLogin(false);
|
|
||||||
}
|
|
||||||
return HandlerInterceptor.super.preHandle(request, response, handler);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,84 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.entity.Category;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Mapper
|
|
||||||
public interface CategoryMapper {
|
|
||||||
/**
|
|
||||||
* 此方法负责接收一个Category对象，并执行插入操作，具体操作如将分类信息保存到数据库
|
|
||||||
* 主要用于添加新的分类信息
|
|
||||||
*
|
|
||||||
* @param category 要插入的分类对象，包含分类相关信息
|
|
||||||
* @return 返回插入操作的结果，表示插入的记录数
|
|
||||||
*/
|
|
||||||
int insert(Category category);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量插入分类数据
|
|
||||||
*
|
|
||||||
* @param categories 分类对象列表，包含多个Category实例
|
|
||||||
* @return 插入操作影响的行数
|
|
||||||
*/
|
|
||||||
int insertBatch(@Param("categories") List<Category> categories);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取所有分类
|
|
||||||
*
|
|
||||||
* @return 分类列表
|
|
||||||
*/
|
|
||||||
List<Category> categoryList();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据分类ID查找分类信息
|
|
||||||
*
|
|
||||||
* @param categoryId 分类ID，用于唯一标识一个分类
|
|
||||||
* @return 返回找到的Category对象，如果不存在则返回null
|
|
||||||
*/
|
|
||||||
Category findById(Integer categoryId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量通过分类ID查找分类信息
|
|
||||||
* 此方法允许一次性查询多个分类的信息，通过提供一个分类ID列表作为参数
|
|
||||||
*
|
|
||||||
* @param categoryIds 分类ID列表，用于指定需要查找的分类
|
|
||||||
* @return 匹配给定ID的分类对象列表如果没有找到匹配的分类，则返回空列表
|
|
||||||
*/
|
|
||||||
List<Category> findByIdBatch(@Param("categoryIds") List<Integer> categoryIds);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据分类ID或父分类ID查找分类信息
|
|
||||||
* 此方法旨在处理分类信息的查询，通过分类ID或父分类ID来过滤并返回匹配的分类对象列表
|
|
||||||
*
|
|
||||||
* @param categoryId 分类ID或父分类ID，用于查找分类的依据
|
|
||||||
* @return 返回一个Category对象的列表，这些对象的分类ID或父分类ID与给定的categoryId匹配
|
|
||||||
*/
|
|
||||||
List<Category> findByIdOrParentId(Integer categoryId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除分类以及子分类
|
|
||||||
*
|
|
||||||
* @param categoryId 分类 ID
|
|
||||||
*/
|
|
||||||
int deleteById(Integer categoryId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量删除分类
|
|
||||||
* 通过多个分类ID一次性删除对应的分类信息
|
|
||||||
*
|
|
||||||
* @param categoryIds 包含多个分类ID的列表，用于指定需要删除的分类
|
|
||||||
* @return 返回删除操作的影响行数，表示成功删除的分类数量
|
|
||||||
*/
|
|
||||||
int deleteByIdBatch(@Param("categoryIds") List<Integer> categoryIds);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新分类信息
|
|
||||||
*
|
|
||||||
* @param category 要更新的分类对象，包含新的分类信息
|
|
||||||
* @return 返回更新操作的影响行数，表示成功更新的分类数量
|
|
||||||
*/
|
|
||||||
int update(Category category);
|
|
||||||
}
|
|
||||||
@ -1,71 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.entity.Collection;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Mapper
|
|
||||||
public interface CollectionMapper {
|
|
||||||
/**
|
|
||||||
* 根据ID查询收藏夹
|
|
||||||
*
|
|
||||||
* @param collectionId 收藏夹的ID
|
|
||||||
* @return 返回查询到的收藏夹对象
|
|
||||||
*/
|
|
||||||
Collection findById(@Param("collectionId") Integer collectionId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据创建者 ID 查询收藏夹
|
|
||||||
*
|
|
||||||
* @param creatorId 创建者 ID
|
|
||||||
* @return 返回查询到的收藏夹列表
|
|
||||||
*/
|
|
||||||
List<Collection> findByCreatorId(@Param("creatorId") Long creatorId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据收藏夹 ID 和创建者 ID 查询收藏夹
|
|
||||||
*
|
|
||||||
* @param collectionId 收藏夹 ID
|
|
||||||
* @param creatorId 创建者 ID
|
|
||||||
* @return 返回查询到的收藏夹对象
|
|
||||||
*/
|
|
||||||
Collection findByIdAndCreatorId(@Param("collectionId") Integer collectionId, @Param("creatorId") Long creatorId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据收藏夹 ID、创建者 ID 和笔记 ID 查询收藏夹
|
|
||||||
*
|
|
||||||
* @param collectionId 收藏夹 ID
|
|
||||||
* @param creatorId 创建者 ID
|
|
||||||
* @param noteId 笔记 ID
|
|
||||||
* @return 返回查询到的收藏夹对象
|
|
||||||
*/
|
|
||||||
int countByCreatorIdAndNoteId(
|
|
||||||
@Param("creatorId") Long creatorId,
|
|
||||||
@Param("noteId") Integer noteId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 创建收藏夹
|
|
||||||
*
|
|
||||||
* @param collection 要创建的收藏夹对象
|
|
||||||
* @return 返回插入操作的影响行数
|
|
||||||
*/
|
|
||||||
int insert(Collection collection);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新收藏夹
|
|
||||||
*
|
|
||||||
* @param collection 要更新的收藏夹对象
|
|
||||||
* @return 返回更新操作的影响行数
|
|
||||||
*/
|
|
||||||
int update(Collection collection);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除收藏夹
|
|
||||||
*
|
|
||||||
* @param collectionId 要删除的收藏夹的ID
|
|
||||||
* @return 返回删除操作的影响行数
|
|
||||||
*/
|
|
||||||
int deleteById(@Param("collectionId") Integer collectionId);
|
|
||||||
}
|
|
||||||
@ -1,61 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.entity.CollectionNote;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
import java.util.Set;
|
|
||||||
|
|
||||||
@Mapper
|
|
||||||
public interface CollectionNoteMapper {
|
|
||||||
/**
|
|
||||||
* 查询用户收藏的笔记 ID 列表
|
|
||||||
*
|
|
||||||
* @param userId 用户 ID
|
|
||||||
* @param noteIds 笔记 ID 列表
|
|
||||||
* @return 用户收藏的笔记 ID 列表
|
|
||||||
*/
|
|
||||||
List<Integer> findUserCollectedNoteIds(
|
|
||||||
@Param("userId") Long userId,
|
|
||||||
@Param("noteIds") List<Integer> noteIds
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 筛选出所给的收藏夹 ID 列表中，收藏了 noteId 对应的 note 的记录
|
|
||||||
*
|
|
||||||
* @param noteId 笔记 ID
|
|
||||||
* @param collectionIds 收藏夹 ID 列表
|
|
||||||
* @return 筛选结果
|
|
||||||
*/
|
|
||||||
Set<Integer> filterCollectionIdsByNoteId(
|
|
||||||
@Param("noteId") Integer noteId,
|
|
||||||
@Param("collectionIds") List<Integer> collectionIds);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 插入记录
|
|
||||||
*
|
|
||||||
* @param collectionNote 收藏笔记记录
|
|
||||||
* @return 插入记录数
|
|
||||||
*/
|
|
||||||
int insert(CollectionNote collectionNote);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据 collectionId 删除记录
|
|
||||||
*
|
|
||||||
* @param collectionId 收藏夹 ID
|
|
||||||
* @return 删除记录数
|
|
||||||
*/
|
|
||||||
int deleteByCollectionId(@Param("collectionId") Integer collectionId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据 collectionId 和 noteId 删除记录
|
|
||||||
*
|
|
||||||
* @param collectionId 收藏夹 ID
|
|
||||||
* @param noteId 笔记 ID
|
|
||||||
* @return 删除记录数
|
|
||||||
*/
|
|
||||||
int deleteByCollectionIdAndNoteId(
|
|
||||||
@Param("collectionId") Integer collectionId,
|
|
||||||
@Param("noteId") Integer noteId);
|
|
||||||
}
|
|
||||||
@ -1,52 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.entity.NoteLike;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Mapper
|
|
||||||
public interface NoteLikeMapper {
|
|
||||||
/**
|
|
||||||
* 插入一个点赞记录
|
|
||||||
*
|
|
||||||
* @param noteLike 要插入的点赞记录对象，包含了用户ID和笔记ID等信息
|
|
||||||
* @return 返回影响的行数，表示插入操作是否成功
|
|
||||||
*/
|
|
||||||
int insert(NoteLike noteLike);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除一个点赞记录对象
|
|
||||||
*
|
|
||||||
* @param noteLike 要删除的点赞记录，通常包含用户ID和笔记ID以定位数据库中的记录
|
|
||||||
* @return 返回影响的行数，表示删除操作是否成功
|
|
||||||
*/
|
|
||||||
int delete(NoteLike noteLike);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据用户ID和笔记ID列表，查找用户点赞过笔记ID列表
|
|
||||||
* 此方法用于过滤给定的笔记ID列表，仅返回该用户标记为点赞过笔记ID
|
|
||||||
*
|
|
||||||
* @param userId 用户ID，用于标识用户
|
|
||||||
* @param noteIds 笔记ID列表，待过滤的笔记ID集合
|
|
||||||
* @return 用户点赞过笔记ID列表
|
|
||||||
*/
|
|
||||||
List<Integer> findUserLikedNoteIds(
|
|
||||||
@Param("userId") Long userId,
|
|
||||||
@Param("noteIds") List<Integer> noteIds
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据用户ID和笔记ID，查找特定的笔记点赞记录
|
|
||||||
* 此方法用于验证用户是否点赞特定的笔记，通过用户ID和笔记ID的组合来查询
|
|
||||||
*
|
|
||||||
* @param userId 用户ID，用于标识用户
|
|
||||||
* @param noteId 笔记ID，用于标识笔记
|
|
||||||
* @return 笔记点赞记录，如果找到则返回，否则返回null
|
|
||||||
*/
|
|
||||||
NoteLike findByUserIdAndNoteId(
|
|
||||||
@Param("userId") Long userId,
|
|
||||||
@Param("noteId") Integer noteId
|
|
||||||
);
|
|
||||||
}
|
|
||||||
@ -1,167 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.dto.note.NoteQueryParams;
|
|
||||||
import com.kama.notes.model.entity.Note;
|
|
||||||
import com.kama.notes.model.vo.note.NoteHeatMapItem;
|
|
||||||
import com.kama.notes.model.vo.note.NoteRankListItem;
|
|
||||||
import com.kama.notes.model.vo.note.Top3Count;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
import java.util.Set;
|
|
||||||
|
|
||||||
@Mapper
|
|
||||||
public interface NoteMapper {
|
|
||||||
/**
|
|
||||||
* 查询笔记的总数
|
|
||||||
*
|
|
||||||
* @param params 查询参数，用于过滤笔记
|
|
||||||
* @return 笔记的总数量
|
|
||||||
*/
|
|
||||||
int countNotes(@Param("params") NoteQueryParams params);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据笔记ID查询笔记
|
|
||||||
*
|
|
||||||
* @param noteId 笔记ID，用于定位特定笔记
|
|
||||||
* @return 返回对应的笔记对象，如果找不到则返回 null
|
|
||||||
*/
|
|
||||||
Note findById(@Param("noteId") Integer noteId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据查询参数获取笔记列表
|
|
||||||
*
|
|
||||||
* @param params 查询参数，用于过滤笔记
|
|
||||||
* @param offset 偏移量，用于分页
|
|
||||||
* @param limit 每页大小，用于分页
|
|
||||||
* @return 笔记列表，返回符合查询条件的笔记
|
|
||||||
*/
|
|
||||||
List<Note> findByQueryParams(@Param("params") NoteQueryParams params,
|
|
||||||
@Param("offset") int offset,
|
|
||||||
@Param("limit") int limit);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据用户ID和问题ID查询笔记
|
|
||||||
*
|
|
||||||
* @param authorId 用户ID，用于标识特定用户
|
|
||||||
* @param questionId 问题ID，用于标识特定问题
|
|
||||||
* @return 返回匹配的笔记对象，如果找不到匹配的笔记，则返回 null
|
|
||||||
*/
|
|
||||||
Note findByAuthorIdAndQuestionId(@Param("authorId") Long authorId,
|
|
||||||
@Param("questionId") Integer questionId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据用户ID查询笔记列表
|
|
||||||
* @param authorId 用户ID
|
|
||||||
* @return 用户创建的笔记列表
|
|
||||||
*/
|
|
||||||
List<Note> findByAuthorId(@Param("authorId") Long authorId);
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据用户ID和问题ID列表，过滤出用户已完成的问题ID列表
|
|
||||||
*
|
|
||||||
* @param authorId 用户ID，用于标识特定用户
|
|
||||||
* @param questionIds 问题ID列表，表示待查询的问题范围
|
|
||||||
* @return 用户已完成的问题ID列表，如果用户未完成任何问题，则返回空集合
|
|
||||||
*/
|
|
||||||
Set<Integer> filterFinishedQuestionIdsByUser(@Param("authorId") Long authorId,
|
|
||||||
@Param("questionIds") List<Integer> questionIds);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 插入一条新的笔记
|
|
||||||
*
|
|
||||||
* @param note 笔记对象，包含要插入的笔记信息
|
|
||||||
* @return 插入成功
|
|
||||||
*/
|
|
||||||
int insert(Note note);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新笔记信息
|
|
||||||
*
|
|
||||||
* @param note 笔记对象，包含要更新的笔记信息
|
|
||||||
* @return 更新成功记录数
|
|
||||||
*/
|
|
||||||
int update(Note note);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 点赞笔记
|
|
||||||
*
|
|
||||||
* @param noteId 笔记ID，用于标识要点赞的笔记
|
|
||||||
* @return 点赞成功记录数
|
|
||||||
*/
|
|
||||||
int likeNote(@Param("noteId") Integer noteId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 取消点赞笔记
|
|
||||||
*
|
|
||||||
* @param noteId 笔记ID，用于标识要取消点赞的笔记
|
|
||||||
* @return 取消点赞成功记录数
|
|
||||||
*/
|
|
||||||
int unlikeNote(@Param("noteId") Integer noteId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 收藏笔记
|
|
||||||
*
|
|
||||||
* @param noteId 笔记ID，用于标识要收藏的笔记
|
|
||||||
* @return 收藏结果
|
|
||||||
*/
|
|
||||||
int collectNote(@Param("noteId") Integer noteId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 取消收藏笔记
|
|
||||||
*
|
|
||||||
* @param noteId 笔记ID，用于标识要取消收藏的笔记
|
|
||||||
* @return 取消收藏结果
|
|
||||||
*/
|
|
||||||
int unCollectNote(@Param("noteId") Integer noteId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据笔记ID删除笔记
|
|
||||||
*
|
|
||||||
* @param noteId 笔记ID，用于标识要删除的笔记
|
|
||||||
* @return 删除成功记录数
|
|
||||||
*/
|
|
||||||
int deleteById(@Param("noteId") Integer noteId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 每日笔记提交数排行榜
|
|
||||||
*
|
|
||||||
* @return 排行榜数组
|
|
||||||
*/
|
|
||||||
List<NoteRankListItem> submitNoteRank();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 提交热力图
|
|
||||||
*
|
|
||||||
* @return 用户提交热力图信息
|
|
||||||
*/
|
|
||||||
List<NoteHeatMapItem> submitNoteHeatMap(@Param("authorId") Long authorId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户提交 top3Count
|
|
||||||
*
|
|
||||||
* @return 用户提交 top3Count
|
|
||||||
*/
|
|
||||||
Top3Count submitNoteTop3Count(@Param("authorId") Long authorId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 当日笔记数
|
|
||||||
*
|
|
||||||
* @return 当日笔记数
|
|
||||||
*/
|
|
||||||
int getTodayNoteCount();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 当日提交笔记人数
|
|
||||||
* @return 当日提交笔记人数
|
|
||||||
*/
|
|
||||||
int getTodaySubmitNoteUserCount();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 笔记总数
|
|
||||||
* @return 笔记总数
|
|
||||||
*/
|
|
||||||
int getTotalNoteCount();
|
|
||||||
}
|
|
||||||
@ -1,79 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.entity.QuestionListItem;
|
|
||||||
import com.kama.notes.model.vo.questionListItem.QuestionListItemVO;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Mapper
|
|
||||||
public interface QuestionListItemMapper {
|
|
||||||
/**
|
|
||||||
* 插入一个题单项
|
|
||||||
*
|
|
||||||
* @param questionListItem 题单项对象，包含需要插入的题单项的信息
|
|
||||||
* @return 影响的行数，表示插入操作是否成功
|
|
||||||
*/
|
|
||||||
int insert(QuestionListItem questionListItem);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据题单ID查找题单项
|
|
||||||
*
|
|
||||||
* @param questionListId 题单的唯一标识符
|
|
||||||
* @return 返回一个包含题单项的列表如果找不到对应的项，则返回空列表
|
|
||||||
*/
|
|
||||||
List<QuestionListItemVO> findByQuestionListId(@Param("questionListId") Integer questionListId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据题单ID查找题单项的数量
|
|
||||||
*
|
|
||||||
* @param questionListId 题单的ID，用于标识要查找的题单项数量
|
|
||||||
* @return 返回题单项的数量
|
|
||||||
*/
|
|
||||||
int countByQuestionListId(@Param("questionListId") Integer questionListId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据题单ID查找题单项（分页）
|
|
||||||
*
|
|
||||||
* @param questionListId 题单的ID，用于标识要查找的题单项
|
|
||||||
* @param limit 每页显示的记录数
|
|
||||||
* @param offset 从第几条记录开始查询
|
|
||||||
*/
|
|
||||||
List<QuestionListItemVO> findByQuestionListIdPage(@Param("questionListId") Integer questionListId,
|
|
||||||
@Param("limit") Integer limit,
|
|
||||||
@Param("offset") Integer offset);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据题单ID删除题单项
|
|
||||||
*
|
|
||||||
* @param questionListId 题单的ID，用于标识要删除的题单项
|
|
||||||
* @return 影响的行数，表示删除操作是否成功
|
|
||||||
*/
|
|
||||||
int deleteByQuestionListId(Integer questionListId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据题单ID和题目ID删除题单项
|
|
||||||
*
|
|
||||||
* @param questionListId 题单的ID，用于标识要删除的题单项
|
|
||||||
* @param questionId 题目的ID，用于标识要删除的题单项
|
|
||||||
* @return 影响的行数，表示删除操作是否成功
|
|
||||||
*/
|
|
||||||
int deleteByQuestionListIdAndQuestionId(@Param("questionListId") Integer questionListId, @Param("questionId") Integer questionId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据题单ID获取下一个序号
|
|
||||||
*
|
|
||||||
* @param questionListId 题单的ID
|
|
||||||
* @return 返回下一个序号
|
|
||||||
*/
|
|
||||||
int nextRank(Integer questionListId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新题单项的序号
|
|
||||||
*
|
|
||||||
* @param questionListItem 新顺序的题单项
|
|
||||||
* @return 影响的行数，表示更新操作是否成功
|
|
||||||
*/
|
|
||||||
int updateQuestionRank(QuestionListItem questionListItem);
|
|
||||||
}
|
|
||||||
@ -1,49 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.entity.QuestionList;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Mapper
|
|
||||||
public interface QuestionListMapper {
|
|
||||||
/**
|
|
||||||
* 插入一个题单
|
|
||||||
*
|
|
||||||
* @param questionList 要插入的题单对象
|
|
||||||
* @return 插入操作影响的行数
|
|
||||||
*/
|
|
||||||
int insert(QuestionList questionList);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据题单ID查找题单
|
|
||||||
*
|
|
||||||
* @param questionListId 题单的唯一标识符
|
|
||||||
* @return 返回找到的题单对象，如果没有找到则返回 null
|
|
||||||
*/
|
|
||||||
QuestionList findById(@Param("questionListId") Integer questionListId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取所有题单
|
|
||||||
*
|
|
||||||
* @return 返回所有题单的列表
|
|
||||||
*/
|
|
||||||
List<QuestionList> findAll();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新一个题单的信息
|
|
||||||
*
|
|
||||||
* @param questionList 要更新的题单对象，包含需要更新的字段
|
|
||||||
* @return 更新操作影响的行数
|
|
||||||
*/
|
|
||||||
int update(QuestionList questionList);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据题单ID删除题单
|
|
||||||
*
|
|
||||||
* @param questionListId 题单的唯一标识符
|
|
||||||
* @return 删除操作影响的行数
|
|
||||||
*/
|
|
||||||
int deleteById(@Param("questionListId") Integer questionListId);
|
|
||||||
}
|
|
||||||
@ -1,101 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.dto.question.QuestionQueryParam;
|
|
||||||
import com.kama.notes.model.entity.Question;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Mapper
|
|
||||||
public interface QuestionMapper {
|
|
||||||
/**
|
|
||||||
* 插入一个问题对象到数据库中
|
|
||||||
*
|
|
||||||
* @param question 要插入的问题对象，包含问题的相关信息
|
|
||||||
* @return 插入成功返回1，否则返回0
|
|
||||||
*/
|
|
||||||
int insert(Question question);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据问题ID查找问题
|
|
||||||
*
|
|
||||||
* @param questionId 问题的唯一标识符
|
|
||||||
* @return 返回找到的问题对象，如果没有找到则返回null
|
|
||||||
*/
|
|
||||||
Question findById(@Param("questionId") Integer questionId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量通过问题 ID查找问题
|
|
||||||
* 此方法允许一次性传入多个问题ID，从而批量获取问题信息
|
|
||||||
*
|
|
||||||
* @param questionIds 一个问题ID的列表，用于指定需要查找的问题
|
|
||||||
* @return 返回一个Question对象的列表，每个对象包含一个问题的详细信息
|
|
||||||
*/
|
|
||||||
List<Question> findByIdBatch(@Param("questionIds") List<Integer> questionIds);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据查询参数获取问题列表
|
|
||||||
*
|
|
||||||
* @param queryParam 查询参数对象，包含多种可能的查询条件
|
|
||||||
* @param offset 分页查询的起始位置
|
|
||||||
* @param limit 每页返回的最大记录数
|
|
||||||
* @return 匹配查询条件的问题列表
|
|
||||||
*/
|
|
||||||
List<Question> findByQueryParam(@Param("queryParam") QuestionQueryParam queryParam,
|
|
||||||
@Param("offset") int offset,
|
|
||||||
@Param("limit") int limit);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据关键字搜索问题
|
|
||||||
*
|
|
||||||
* @param keyword 关键字，用于匹配问题标题或内容
|
|
||||||
* @return 匹配关键字的问题列表
|
|
||||||
*/
|
|
||||||
List<Question> findByKeyword(@Param("keyword") String keyword);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新问题
|
|
||||||
* @param question 问题对象，包含要更新的问题信息
|
|
||||||
* @return 更新成功返回1，否则返回0
|
|
||||||
*/
|
|
||||||
int update(@Param("question") Question question);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新问题的浏览次数
|
|
||||||
* @param questionId 问题ID
|
|
||||||
* @return 更新成功返回1，否则返回0
|
|
||||||
*/
|
|
||||||
int incrementViewCount(@Param("questionId") Integer questionId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据查询参数统计问题的数量
|
|
||||||
*
|
|
||||||
* @param queryParam 查询参数对象，包含多个查询条件
|
|
||||||
* @return 满足查询条件的问题数量
|
|
||||||
*/
|
|
||||||
int countByQueryParam(@Param("queryParam") QuestionQueryParam queryParam);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据问题ID删除问题
|
|
||||||
*
|
|
||||||
* @param questionId 需要删除的问题的ID
|
|
||||||
*/
|
|
||||||
int deleteById(Integer questionId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据分类ID删除相关记录
|
|
||||||
* 此方法旨在删除与给定分类ID 关联的实体
|
|
||||||
*
|
|
||||||
* @param categoryId 分类ID，用于标识要删除的记录
|
|
||||||
*/
|
|
||||||
int deleteByCategoryId(Integer categoryId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量删除指定分类ID的实体
|
|
||||||
* 通过分类ID列表来删除实体，主要用于批量操作场景
|
|
||||||
*
|
|
||||||
* @param categoryIds 分类ID列表，用于指定待删除实体的分类
|
|
||||||
*/
|
|
||||||
int deleteByCategoryIdBatch(@Param("categoryIds") List<Integer> categoryIds);
|
|
||||||
}
|
|
||||||
@ -1,31 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.entity.Statistic;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Mapper
|
|
||||||
public interface StatisticMapper {
|
|
||||||
/**
|
|
||||||
* 添加统计数据
|
|
||||||
* @param statistic 统计数据
|
|
||||||
* @return 添加的记录数
|
|
||||||
*/
|
|
||||||
int insert(Statistic statistic);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取统计数据的 total
|
|
||||||
* @return total
|
|
||||||
*/
|
|
||||||
int countStatistic();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 查询统计数据
|
|
||||||
* @param limit 限制
|
|
||||||
* @param offset 偏移
|
|
||||||
* @return 统计数据
|
|
||||||
*/
|
|
||||||
List<Statistic> findByPage(@Param("limit") Integer limit, @Param("offset") Integer offset);
|
|
||||||
}
|
|
||||||
@ -1,119 +0,0 @@
|
|||||||
package com.kama.notes.mapper;
|
|
||||||
|
|
||||||
import com.kama.notes.model.dto.user.UserQueryParam;
|
|
||||||
import com.kama.notes.model.entity.User;
|
|
||||||
import org.apache.ibatis.annotations.Mapper;
|
|
||||||
import org.apache.ibatis.annotations.Param;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* UserMapper接口定义了用户数据访问对象（DAO）的方法
|
|
||||||
*/
|
|
||||||
@Mapper
|
|
||||||
public interface UserMapper {
|
|
||||||
/**
|
|
||||||
* 插入新用户
|
|
||||||
*
|
|
||||||
* @param user 待插入的用户对象，包含用户的所有信息
|
|
||||||
*/
|
|
||||||
int insert(User user);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据ID查找用户
|
|
||||||
*
|
|
||||||
* @param userId 用户ID，用于查询用户信息
|
|
||||||
* @return 返回用户对象，如果未找到则返回null
|
|
||||||
*/
|
|
||||||
User findById(@Param("userId") Long userId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据 ID 数组批量查找用户
|
|
||||||
*
|
|
||||||
* @param userIds 用户ID列表，用于批量查询用户信息
|
|
||||||
* @return 返回用户列表，如果未找到任何用户则返回空列表
|
|
||||||
*/
|
|
||||||
List<User> findByIdBatch(@Param("userIds") List<Long> userIds);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据账号查找用户
|
|
||||||
*
|
|
||||||
* @param account 用户账号，用于查询用户信息
|
|
||||||
* @return 返回用户对象，如果未找到则返回null
|
|
||||||
*/
|
|
||||||
User findByAccount(@Param("account") String account);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据 OpenId 查找用户
|
|
||||||
*
|
|
||||||
* @param openId 用户的 OpenId，用于查询用户信息
|
|
||||||
* @return 返回用户对象，如果未找到则返回 null
|
|
||||||
*/
|
|
||||||
User findByOpenId(@Param("openId") String openId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据 UnionId 查找用户
|
|
||||||
*
|
|
||||||
* @param unionId 用户的 UnionId，用于查询用户信息
|
|
||||||
* @return 返回用户对象，如果未找到则返回 null
|
|
||||||
*/
|
|
||||||
User findByUnionId(@Param("unionId") String unionId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据查询参数查找用户列表
|
|
||||||
*
|
|
||||||
* @param queryParams 用户查询参数对象，封装了查询用户时的各种筛选条件
|
|
||||||
* @return 符合查询条件的用户列表
|
|
||||||
*/
|
|
||||||
List<User> findByQueryParam(@Param("queryParams") UserQueryParam queryParams,
|
|
||||||
@Param("limit") Integer limit,
|
|
||||||
@Param("offset") Integer offset);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据查询参数统计用户数量
|
|
||||||
*
|
|
||||||
* @param queryParams 用户查询参数对象，封装了查询条件
|
|
||||||
* @return 满足查询条件的用户数量
|
|
||||||
*/
|
|
||||||
int countByQueryParam(@Param("queryParams") UserQueryParam queryParams);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新用户信息
|
|
||||||
*
|
|
||||||
* @param user 待更新的用户对象，包含用户的所有信息
|
|
||||||
*/
|
|
||||||
int update(User user);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新用户在线时间
|
|
||||||
*
|
|
||||||
* @param userId 用户ID，用于标识需要更新在线时间的用户
|
|
||||||
*/
|
|
||||||
int updateLastLoginAt(@Param("userId") Long userId);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 绑定手机号
|
|
||||||
* @param userId 用户ID
|
|
||||||
* @param phone 手机号码
|
|
||||||
* @return 绑定结果
|
|
||||||
*/
|
|
||||||
int bindPhone(@Param("userId") Long userId, @Param("phone") String phone);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取今日登录人数
|
|
||||||
* @return 今日登录人数
|
|
||||||
*/
|
|
||||||
int getTodayLoginCount();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 今日注册人数
|
|
||||||
* @return 今日注册人数
|
|
||||||
*/
|
|
||||||
int getTodayRegisterCount();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 总注册人数
|
|
||||||
* @return 总注册人数
|
|
||||||
*/
|
|
||||||
int getTotalRegisterCount();
|
|
||||||
}
|
|
||||||
@ -1,14 +0,0 @@
|
|||||||
package com.kama.notes.model.base;
|
|
||||||
|
|
||||||
import lombok.AllArgsConstructor;
|
|
||||||
import lombok.Data;
|
|
||||||
import lombok.NoArgsConstructor;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
@NoArgsConstructor
|
|
||||||
@AllArgsConstructor
|
|
||||||
public class ApiResponse<T> {
|
|
||||||
private Integer code;
|
|
||||||
private String msg;
|
|
||||||
private T data;
|
|
||||||
}
|
|
||||||
@ -1,6 +0,0 @@
|
|||||||
package com.kama.notes.model.base;
|
|
||||||
|
|
||||||
// 占位
|
|
||||||
// 用于操作成功，只需要返回状态码，无任何额外数据时使用
|
|
||||||
public class EmptyVO {
|
|
||||||
}
|
|
||||||
@ -1,12 +0,0 @@
|
|||||||
package com.kama.notes.model.base;
|
|
||||||
|
|
||||||
import lombok.AllArgsConstructor;
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
@AllArgsConstructor
|
|
||||||
public class Pagination {
|
|
||||||
private Integer page; // 当前页码
|
|
||||||
private Integer pageSize; // 每页显示的记录数
|
|
||||||
private Integer total; // 总记录数
|
|
||||||
}
|
|
||||||
@ -1,34 +0,0 @@
|
|||||||
package com.kama.notes.model.base;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* PaginationApiResponse类用于处理分页的API响应
|
|
||||||
* 它继承自ApiResponse类，并添加了分页信息的支持
|
|
||||||
*
|
|
||||||
* @param <T> 泛型参数，表示API响应中携带的数据类型
|
|
||||||
*/
|
|
||||||
public class PaginationApiResponse<T> extends ApiResponse<T> {
|
|
||||||
// 分页信息对象
|
|
||||||
private final Pagination pagination;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 构造方法，用于创建PaginationApiResponse对象
|
|
||||||
*
|
|
||||||
* @param code 响应代码
|
|
||||||
* @param msg 响应消息
|
|
||||||
* @param data 响应数据，类型为泛型T
|
|
||||||
* @param pagination 分页信息对象，包含分页相关数据
|
|
||||||
*/
|
|
||||||
public PaginationApiResponse(int code, String msg, T data, Pagination pagination) {
|
|
||||||
super(code, msg, data); // 调用父类ApiResponse的构造方法
|
|
||||||
this.pagination = pagination; // 初始化分页信息
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取分页信息的方法
|
|
||||||
*
|
|
||||||
* @return 返回Pagination对象，包含分页相关数据
|
|
||||||
*/
|
|
||||||
public Pagination getPagination() {
|
|
||||||
return pagination;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,36 +0,0 @@
|
|||||||
package com.kama.notes.model.base;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import lombok.EqualsAndHashCode;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* TokenApiResponse类是ApiResponse的一个子类，用于处理包含Token的API响应
|
|
||||||
* 它提供了一个方法来获取Token
|
|
||||||
*
|
|
||||||
* @param <T> 泛型参数，表示API响应中数据的类型
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
@EqualsAndHashCode(callSuper = true)
|
|
||||||
public class TokenApiResponse<T> extends ApiResponse<T> {
|
|
||||||
/**
|
|
||||||
* -- GETTER --
|
|
||||||
* 获取Token的方法
|
|
||||||
*
|
|
||||||
* @return 返回API响应中的Token
|
|
||||||
*/
|
|
||||||
// 用于存储API响应中的Token
|
|
||||||
private final String token;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 构造函数，用于初始化TokenApiResponse对象
|
|
||||||
*
|
|
||||||
* @param code 状态码，表示API响应的状态
|
|
||||||
* @param msg 消息，提供关于API响应的额外信息
|
|
||||||
* @param data 数据，包含API响应的具体内容
|
|
||||||
* @param token Token，包含API响应中的Token
|
|
||||||
*/
|
|
||||||
public TokenApiResponse(Integer code, String msg, T data, String token) {
|
|
||||||
super(code, msg, data);
|
|
||||||
this.token = token;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,21 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.category;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import org.hibernate.validator.constraints.Length;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotBlank;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CreateCategoryBody {
|
|
||||||
|
|
||||||
@NotBlank(message = "name 不能为空")
|
|
||||||
@NotNull(message = "name 不能为空")
|
|
||||||
@Length(max = 32, min = 1, message = "name 长度在 1 - 32 之间")
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
@NotNull(message = "parentCategoryId 不能为空")
|
|
||||||
@Min(value = 0, message = "parentCategoryId 必须为正整数")
|
|
||||||
private Integer parentCategoryId;
|
|
||||||
}
|
|
||||||
@ -1,16 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.category;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import org.hibernate.validator.constraints.Length;
|
|
||||||
|
|
||||||
import javax.validation.constraints.NotBlank;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class UpdateCategoryBody {
|
|
||||||
|
|
||||||
@NotBlank(message = "name 不能为空")
|
|
||||||
@NotNull(message = "name 不能为空")
|
|
||||||
@Length(max = 32, min = 1, message = "name 长度在 1 - 32 之间")
|
|
||||||
private String name;
|
|
||||||
}
|
|
||||||
@ -1,16 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.collection;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CollectionQueryParams {
|
|
||||||
@NotNull(message = "creatorId 不能为空")
|
|
||||||
@Min(value = 1, message = "creatorId 必须为正整数")
|
|
||||||
private Long creatorId;
|
|
||||||
|
|
||||||
@Min(value = 1, message = "noteId 必须为正整数")
|
|
||||||
private Integer noteId;
|
|
||||||
}
|
|
||||||
@ -1,14 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.collection;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.NotBlank;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CreateCollectionBody {
|
|
||||||
@NotNull(message = "name 不能为空")
|
|
||||||
@NotBlank(message = "name 不能为空")
|
|
||||||
private String name;
|
|
||||||
private String description;
|
|
||||||
}
|
|
||||||
@ -1,27 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.collection;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotEmpty;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
import javax.validation.constraints.Pattern;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class UpdateCollectionBody {
|
|
||||||
@Min(value = 1, message = "noteId 必须为正整数")
|
|
||||||
private Integer noteId;
|
|
||||||
|
|
||||||
private UpdateItem[] collections;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public static class UpdateItem {
|
|
||||||
@Min(value = 1, message = "collectionId 必须为正整数")
|
|
||||||
private Integer collectionId;
|
|
||||||
// 必须为 create 或者 delete
|
|
||||||
@NotNull(message = "action 不能为空")
|
|
||||||
@NotEmpty(message = "action 不能为空")
|
|
||||||
@Pattern(regexp = "create|delete", message = "action 必须为 create 或者 delete")
|
|
||||||
private String action;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,27 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.note;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotBlank;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 发布笔记请求DTO
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class CreateNoteRequest {
|
|
||||||
/*
|
|
||||||
* 问题ID
|
|
||||||
*/
|
|
||||||
@NotNull(message = "问题 ID 不能为空")
|
|
||||||
@Min(value = 1, message = "问题 ID 必须为正整数")
|
|
||||||
private Integer questionId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 笔记内容
|
|
||||||
*/
|
|
||||||
@NotBlank(message = "笔记内容不能为空")
|
|
||||||
@NotNull(message = "笔记内容不能为空")
|
|
||||||
private String content;
|
|
||||||
}
|
|
||||||
@ -1,81 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.note;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Max;
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
import javax.validation.constraints.Pattern;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 笔记查询参数DTO
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class NoteQueryParams {
|
|
||||||
/*
|
|
||||||
* 问题ID
|
|
||||||
* 必须是正整数
|
|
||||||
*/
|
|
||||||
@Min(value = 1, message = "问题ID必须是正整数")
|
|
||||||
private Integer questionId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 作者ID
|
|
||||||
* 必须是正整数且符合系统生成的范围
|
|
||||||
*/
|
|
||||||
@Min(value = 1, message = "作者ID必须是正整数")
|
|
||||||
private Long authorId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 收藏夹ID
|
|
||||||
* 必须是正整数
|
|
||||||
*/
|
|
||||||
@Min(value = 1, message = "收藏夹ID必须是正整数")
|
|
||||||
private Integer collectionId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 排序字段
|
|
||||||
* 只能是固定的枚举值（比如 "create", "update"）。
|
|
||||||
*/
|
|
||||||
@Pattern(
|
|
||||||
regexp = "create",
|
|
||||||
message = "create"
|
|
||||||
)
|
|
||||||
private String sort;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 排序方向
|
|
||||||
* 只能是 "asc" 或 "desc"，区分大小写。
|
|
||||||
*/
|
|
||||||
@Pattern(
|
|
||||||
regexp = "asc|desc",
|
|
||||||
message = "排序方向必须是 asc 或 desc"
|
|
||||||
)
|
|
||||||
private String order;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 最近天数
|
|
||||||
* 必须是1到365之间的整数，默认限制为一年内。
|
|
||||||
*/
|
|
||||||
@Min(value = 1, message = "最近天数必须至少为1天")
|
|
||||||
@Max(value = 365, message = "最近天数不能超过365天")
|
|
||||||
private Integer recentDays;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 当前页码
|
|
||||||
* 必须是正整数，默认为1。
|
|
||||||
*/
|
|
||||||
@NotNull(message = "当前页码不能为空")
|
|
||||||
@Min(value = 1, message = "当前页码必须大于等于1")
|
|
||||||
@Max(value = 10000, message = "当前页码不能超过10,000")
|
|
||||||
private Integer page = 1;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 每页大小
|
|
||||||
* 必须是正整数，限制范围在 1到100之间。
|
|
||||||
*/
|
|
||||||
@NotNull(message = "每页大小不能为空")
|
|
||||||
@Min(value = 1, message = "每页大小必须大于等于1")
|
|
||||||
@Max(value = 200, message = "每页大小不能超过100")
|
|
||||||
private Integer pageSize = 10;
|
|
||||||
}
|
|
||||||
@ -1,19 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.note;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.NotBlank;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新笔记请求DTO
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class UpdateNoteRequest {
|
|
||||||
/*
|
|
||||||
* 笔记内容
|
|
||||||
*/
|
|
||||||
@NotNull(message = "笔记内容不能为空")
|
|
||||||
@NotBlank(message = "笔记内容不能为空")
|
|
||||||
private String content;
|
|
||||||
}
|
|
||||||
@ -1,13 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.notification;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.NotEmpty;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class NotificationDTO {
|
|
||||||
@NotEmpty(message = "content 不能为空")
|
|
||||||
@NotNull(message = "content 不能为空")
|
|
||||||
private String content;
|
|
||||||
}
|
|
||||||
@ -1,28 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.question;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import org.hibernate.validator.constraints.Length;
|
|
||||||
import org.hibernate.validator.constraints.Range;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotBlank;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CreateQuestionBody {
|
|
||||||
@NotNull(message = "categoryId 不能为空")
|
|
||||||
@Min(value = 1, message = "categoryId 必须为正整数")
|
|
||||||
private Integer categoryId;
|
|
||||||
|
|
||||||
@NotNull(message = "title 不能为空")
|
|
||||||
@NotBlank(message = "title 不能为空")
|
|
||||||
@Length(max = 255, message = "title 长度不能超过 255")
|
|
||||||
private String title;
|
|
||||||
|
|
||||||
@NotNull(message = "difficulty 不能为空")
|
|
||||||
@Range(min = 1, max = 3, message = "difficulty 必须为 1, 2, 3")
|
|
||||||
private Integer difficulty;
|
|
||||||
|
|
||||||
@Length(max = 255, message = "examPoint 长度不能超过 255")
|
|
||||||
private String examPoint;
|
|
||||||
}
|
|
||||||
@ -1,30 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.question;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Max;
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
import javax.validation.constraints.Pattern;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class QuestionQueryParam {
|
|
||||||
|
|
||||||
@Min(value = 1, message = "categoryId 必须为正整数")
|
|
||||||
private Integer categoryId;
|
|
||||||
|
|
||||||
@Pattern(regexp = "^(view|difficulty)$", message = "sort 必须为 view 或 difficulty")
|
|
||||||
private String sort;
|
|
||||||
|
|
||||||
@Pattern(regexp = "^(asc|desc)$", message = "order 必须为 asc 或 desc")
|
|
||||||
private String order;
|
|
||||||
|
|
||||||
@NotNull(message = "page 不能为空")
|
|
||||||
@Min(value = 1, message = "page 必须为正整数")
|
|
||||||
private Integer page;
|
|
||||||
|
|
||||||
@NotNull(message = "pageSize 不能为空")
|
|
||||||
@Min(value = 1, message = "pageSize 必须为正整数")
|
|
||||||
@Max(value = 200, message = "pageSize 不能超过 200")
|
|
||||||
private Integer pageSize;
|
|
||||||
}
|
|
||||||
@ -1,16 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.question;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import org.hibernate.validator.constraints.Length;
|
|
||||||
|
|
||||||
import javax.validation.constraints.NotEmpty;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class SearchQuestionBody {
|
|
||||||
@NotNull(message = "keyword 不能为空")
|
|
||||||
@NotEmpty(message = "keyword 不能为空")
|
|
||||||
@Length(min = 1, max = 32, message = "keyword 长度在 1 和 32 范围内")
|
|
||||||
private String keyword;
|
|
||||||
// TODO: 后续需要完善，添加分页功能
|
|
||||||
}
|
|
||||||
@ -1,33 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.question;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import org.hibernate.validator.constraints.Length;
|
|
||||||
import org.hibernate.validator.constraints.Range;
|
|
||||||
|
|
||||||
import javax.validation.constraints.NotBlank;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class UpdateQuestionBody {
|
|
||||||
/*
|
|
||||||
* 问题标题
|
|
||||||
*/
|
|
||||||
@NotNull(message = "title 不能为空")
|
|
||||||
@NotBlank(message = "title 不能为空")
|
|
||||||
@Length(max = 255, message = "title 长度不能超过 255")
|
|
||||||
private String title;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 问题难度
|
|
||||||
* 1=简单，2=中等，3=困难
|
|
||||||
*/
|
|
||||||
@NotNull(message = "difficulty 不能为空")
|
|
||||||
@Range(min = 1, max = 3, message = "difficulty 必须为 1, 2, 3")
|
|
||||||
private Integer difficulty;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 题目考点
|
|
||||||
*/
|
|
||||||
@Length(max = 255, message = "examPoint 长度不能超过 255")
|
|
||||||
private String examPoint;
|
|
||||||
}
|
|
||||||
@ -1,26 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.questionList;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import org.hibernate.validator.constraints.Length;
|
|
||||||
import org.hibernate.validator.constraints.Range;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CreateQuestionListBody {
|
|
||||||
/*
|
|
||||||
* 题单名称
|
|
||||||
*/
|
|
||||||
@Length(max = 32, message = "name 长度不能超过 32")
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 题单类型
|
|
||||||
*/
|
|
||||||
@Range(min = 1, max = 2, message = "type 必须为 1 或 2")
|
|
||||||
private Integer type;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 题单描述
|
|
||||||
*/
|
|
||||||
@Length(max = 255, message = "description 长度不能超过 255")
|
|
||||||
private String description;
|
|
||||||
}
|
|
||||||
@ -1,26 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.questionList;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import org.hibernate.validator.constraints.Length;
|
|
||||||
import org.hibernate.validator.constraints.Range;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class UpdateQuestionListBody {
|
|
||||||
/*
|
|
||||||
* 题单名称
|
|
||||||
*/
|
|
||||||
@Length(max = 32, message = "name 长度不能超过 32")
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 题单类型
|
|
||||||
*/
|
|
||||||
@Range(min = 1, max = 2, message = "type 必须为 1 或 2")
|
|
||||||
private Integer type;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 题单描述
|
|
||||||
*/
|
|
||||||
@Length(max = 255, message = "description 长度不能超过 255")
|
|
||||||
private String description;
|
|
||||||
}
|
|
||||||
@ -1,17 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.questionListItem;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CreateQuestionListItemBody {
|
|
||||||
@NotNull(message = "questionListId 不能为空")
|
|
||||||
@Min(value = 1, message = "questionListId 必须为正整数")
|
|
||||||
private Integer questionListId;
|
|
||||||
|
|
||||||
@NotNull(message = "questionId 不能为空")
|
|
||||||
@Min(value = 1, message = "questionId 必须为正整数")
|
|
||||||
private Integer questionId;
|
|
||||||
}
|
|
||||||
@ -1,22 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.questionListItem;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import org.hibernate.validator.constraints.Range;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class QuestionListItemQueryParams {
|
|
||||||
@NotNull(message = "questionListId 不能为空")
|
|
||||||
@Min(value = 1, message = "questionListId 必须为正整数")
|
|
||||||
private Integer questionListId;
|
|
||||||
|
|
||||||
@NotNull(message = "page 不能为空")
|
|
||||||
@Min(value = 1, message = "page 必须为正整数")
|
|
||||||
private Integer page;
|
|
||||||
|
|
||||||
@NotNull(message = "pageSize 不能为空")
|
|
||||||
@Range(min = 1, max = 100, message = "pageSize 必须为 1 到 100 之间的整数")
|
|
||||||
private Integer pageSize;
|
|
||||||
}
|
|
||||||
@ -1,17 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.questionListItem;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class SortQuestionListItemBody {
|
|
||||||
@NotNull(message = "questionListId 不能为空")
|
|
||||||
@Min(value = 1, message = "questionListId 必须为正整数")
|
|
||||||
private Integer questionListId;
|
|
||||||
|
|
||||||
@NotNull(message = "questionListItemIds 不能为空")
|
|
||||||
private List<Integer> questionIds;
|
|
||||||
}
|
|
||||||
@ -1,17 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.statistic;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class StatisticQueryParam {
|
|
||||||
@NotNull(message = "page 不能为空")
|
|
||||||
@Min(value = 1, message = "page 必须为正整数")
|
|
||||||
private Integer page;
|
|
||||||
|
|
||||||
@NotNull(message = "page 不能为空")
|
|
||||||
@Min(value = 1, message = "page 必须为正整数")
|
|
||||||
private Integer pageSize;
|
|
||||||
}
|
|
||||||
@ -1,29 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.user;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.NotBlank;
|
|
||||||
import javax.validation.constraints.Pattern;
|
|
||||||
import javax.validation.constraints.Size;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 登录请求DTO
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class LoginRequest {
|
|
||||||
/*
|
|
||||||
* 用户账号
|
|
||||||
*/
|
|
||||||
@NotBlank(message = "用户账号不能为空")
|
|
||||||
@Size(min = 6, max = 32, message = "账号长度必须在 6 到 32 个字符之间")
|
|
||||||
@Pattern(regexp = "^[a-zA-Z0-9_]+$", message = "账号只能包含字母、数字和下划线")
|
|
||||||
private String account;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 登录密码
|
|
||||||
* 必填，长度 6-32
|
|
||||||
*/
|
|
||||||
@NotBlank(message = "密码不能为空")
|
|
||||||
@Size(min = 6, max = 32, message = "密码长度必须在 6 到 32 个字符之间")
|
|
||||||
private String password;
|
|
||||||
}
|
|
||||||
@ -1,40 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.user;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.NotBlank;
|
|
||||||
import javax.validation.constraints.Pattern;
|
|
||||||
import javax.validation.constraints.Size;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户注册请求DTO
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class RegisterRequest {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户账号
|
|
||||||
* 必填，长度 6-32，支持字母、数字和下划线
|
|
||||||
*/
|
|
||||||
@NotBlank(message = "用户账号不能为空")
|
|
||||||
@Size(min = 6, max = 32, message = "账号长度必须在 6 到 32 个字符之间")
|
|
||||||
@Pattern(regexp = "^[a-zA-Z0-9_]+$", message = "账号只能包含字母、数字和下划线")
|
|
||||||
private String account;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户昵称
|
|
||||||
* 必填，长度 1-16，支持中文、字母、数字、下划线、分隔符
|
|
||||||
*/
|
|
||||||
@NotBlank(message = "用户名不能为空")
|
|
||||||
@Size(max = 16, message = "用户名长度不能超过 16 个字符")
|
|
||||||
@Pattern(regexp = "^[\\u4e00-\\u9fa5_a-zA-Z0-9\\-\\.]+$", message = "用户名只能包含中文、字母、数字、下划线、分隔符")
|
|
||||||
private String username;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 登录密码
|
|
||||||
* 必填，长度 6-32
|
|
||||||
*/
|
|
||||||
@NotBlank(message = "密码不能为空")
|
|
||||||
@Size(min = 6, max = 32, message = "密码长度必须在 6 到 32 个字符之间")
|
|
||||||
private String password;
|
|
||||||
}
|
|
||||||
@ -1,63 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.user;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import javax.validation.constraints.*;
|
|
||||||
import java.time.LocalDate;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户信息更新请求 DTO
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class UpdateUserRequest {
|
|
||||||
/**
|
|
||||||
* 用户昵称
|
|
||||||
* 非必填，长度在 1-16 个字符，允许中文、字母、数字、下划线。
|
|
||||||
*/
|
|
||||||
@Size(min = 1, max = 16, message = "用户名长度必须在 1 到 16 个字符之间")
|
|
||||||
@Pattern(regexp = "^[\\u4e00-\\u9fa5_a-zA-Z0-9]+$", message = "用户名只能包含中文、字母、数字和下划线")
|
|
||||||
private String username;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户性别
|
|
||||||
* 非必填，取值范围：1=男，2=女，3=保密。
|
|
||||||
*/
|
|
||||||
@Min(value = 1, message = "性别取值无效")
|
|
||||||
@Max(value = 3, message = "性别取值无效")
|
|
||||||
private Integer gender;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户生日
|
|
||||||
* 非必填，必须是过去的日期。
|
|
||||||
*/
|
|
||||||
@Past(message = "生日必须是一个过去的日期")
|
|
||||||
private LocalDate birthday;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户头像
|
|
||||||
* 非必填，必须是有效的 URL。
|
|
||||||
*/
|
|
||||||
@Pattern(regexp = "^(https?|ftp)://.*$", message = "头像地址必须是有效的 URL")
|
|
||||||
private String avatarUrl;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户邮箱
|
|
||||||
* 非必填，必须是有效的邮箱地址。
|
|
||||||
*/
|
|
||||||
@Email(message = "邮箱格式无效")
|
|
||||||
private String email;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户学校
|
|
||||||
* 非必填，长度在 1-64 个字符。
|
|
||||||
*/
|
|
||||||
@Size(max = 64, message = "学校名称长度不能超过 64 个字符")
|
|
||||||
private String school;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户签名
|
|
||||||
* 非必填，长度在 1-128 个字符。
|
|
||||||
*/
|
|
||||||
@Size(max = 128, message = "签名长度不能超过 128 个字符")
|
|
||||||
private String signature;
|
|
||||||
}
|
|
||||||
@ -1,38 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.user;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import lombok.AllArgsConstructor;
|
|
||||||
import lombok.NoArgsConstructor;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 图片上传响应DTO
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
@NoArgsConstructor
|
|
||||||
@AllArgsConstructor
|
|
||||||
public class UploadImageResponse {
|
|
||||||
/*
|
|
||||||
* 状态码
|
|
||||||
*/
|
|
||||||
private Integer code;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 提示信息
|
|
||||||
*/
|
|
||||||
private String msg;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 响应数据
|
|
||||||
*/
|
|
||||||
private UploadImageResponseData data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
@NoArgsConstructor
|
|
||||||
@AllArgsConstructor
|
|
||||||
public static class UploadImageResponseData {
|
|
||||||
/*
|
|
||||||
* 图片访问URL
|
|
||||||
*/
|
|
||||||
private String url;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,35 +0,0 @@
|
|||||||
package com.kama.notes.model.dto.user;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import org.hibernate.validator.constraints.Length;
|
|
||||||
import javax.validation.constraints.Max;
|
|
||||||
import javax.validation.constraints.Min;
|
|
||||||
import javax.validation.constraints.NotNull;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class UserQueryParam {
|
|
||||||
@Min(value = 1, message = "userId 必须为正整数")
|
|
||||||
private Long userId;
|
|
||||||
|
|
||||||
private String account;
|
|
||||||
|
|
||||||
@Length(max = 16, message = "用户名长度不能超过 16 个字符")
|
|
||||||
private String username;
|
|
||||||
|
|
||||||
@Min(value = 0, message = "isAdmin 最小只能是 0")
|
|
||||||
@Max(value = 1, message = "isAdmin 最大只能是 1")
|
|
||||||
private Integer isAdmin;
|
|
||||||
|
|
||||||
@Min(value = 0, message = "isBanned 最小只能是 0")
|
|
||||||
@Max(value = 1, message = "isBanned 最大只能是 1")
|
|
||||||
private Integer isBanned;
|
|
||||||
|
|
||||||
@NotNull(message = "page 不能为空")
|
|
||||||
@Min(value = 1, message = "page 必须为正整数")
|
|
||||||
private Integer page;
|
|
||||||
|
|
||||||
@NotNull(message = "pageSize 不能为空")
|
|
||||||
@Min(value = 1, message = "pageSize 必须为正整数")
|
|
||||||
@Max(value = 200, message = "pageSize 不能超过 200")
|
|
||||||
private Integer pageSize;
|
|
||||||
}
|
|
||||||
@ -1,40 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName Category
|
|
||||||
* @Description 分类实体类
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-16 19:53
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class Category {
|
|
||||||
/*
|
|
||||||
* 分类ID（主键）
|
|
||||||
*/
|
|
||||||
private Integer categoryId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 分类名称
|
|
||||||
*/
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 上级分类ID
|
|
||||||
* 为0时表示当前分类是一级分类
|
|
||||||
*/
|
|
||||||
private Integer parentCategoryId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 创建时间
|
|
||||||
*/
|
|
||||||
private Date createdAt;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 更新时间
|
|
||||||
*/
|
|
||||||
private Date updatedAt;
|
|
||||||
}
|
|
||||||
@ -1,40 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 收藏夹实体类
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class Collection {
|
|
||||||
/*
|
|
||||||
* 收藏夹ID（主键）
|
|
||||||
*/
|
|
||||||
private Integer collectionId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 收藏夹名称
|
|
||||||
*/
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 收藏夹描述
|
|
||||||
*/
|
|
||||||
private String description;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 收藏夹创建者ID
|
|
||||||
*/
|
|
||||||
private Long creatorId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 创建时间
|
|
||||||
*/
|
|
||||||
private Date createdAt;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 更新时间
|
|
||||||
*/
|
|
||||||
private Date updatedAt;
|
|
||||||
}
|
|
||||||
@ -1,34 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName CollectionNote
|
|
||||||
* @Description 收藏夹-笔记关联实体类
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-16 20:11
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class CollectionNote {
|
|
||||||
/*
|
|
||||||
* 收藏夹ID（联合主键）
|
|
||||||
*/
|
|
||||||
private Integer collectionId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 笔记ID（联合主键）
|
|
||||||
*/
|
|
||||||
private Integer noteId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 创建时间
|
|
||||||
*/
|
|
||||||
private Date createdAt;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 更新时间
|
|
||||||
*/
|
|
||||||
private Date updatedAt;
|
|
||||||
}
|
|
||||||
@ -1,61 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import java.time.LocalDateTime;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName Note
|
|
||||||
* @Description 笔记实体类
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-16 20:01
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class Note {
|
|
||||||
/*
|
|
||||||
* 笔记ID（主键）
|
|
||||||
*/
|
|
||||||
private Integer noteId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 笔记作者ID
|
|
||||||
*/
|
|
||||||
private Long authorId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 笔记对应的问题ID
|
|
||||||
*/
|
|
||||||
private Integer questionId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 笔记内容
|
|
||||||
*/
|
|
||||||
private String content;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 点赞数
|
|
||||||
*/
|
|
||||||
private Integer likeCount;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 评论数
|
|
||||||
*/
|
|
||||||
private Integer commentCount;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 收藏数
|
|
||||||
*/
|
|
||||||
private Integer collectCount;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 创建时间
|
|
||||||
*/
|
|
||||||
private LocalDateTime createdAt;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 更新时间
|
|
||||||
*/
|
|
||||||
private LocalDateTime updatedAt;
|
|
||||||
}
|
|
||||||
@ -1,34 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName NoteLike
|
|
||||||
* @Description 笔记点赞关联实体类
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-16 20:04
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class NoteLike {
|
|
||||||
/*
|
|
||||||
* 笔记ID（联合主键）
|
|
||||||
*/
|
|
||||||
private Integer noteId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 点赞用户ID（联合主键）
|
|
||||||
*/
|
|
||||||
private Long userId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 创建时间
|
|
||||||
*/
|
|
||||||
private Date createdAt;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 更新时间
|
|
||||||
*/
|
|
||||||
private Date updatedAt;
|
|
||||||
}
|
|
||||||
@ -1,57 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import java.time.LocalDateTime;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName Question
|
|
||||||
* @Description 问题实体类
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-16 19:56
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class Question {
|
|
||||||
/*
|
|
||||||
* 问题ID（主键）
|
|
||||||
*/
|
|
||||||
private Integer questionId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 问题所属分类ID
|
|
||||||
*/
|
|
||||||
private Integer categoryId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 问题标题
|
|
||||||
*/
|
|
||||||
private String title;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 问题难度
|
|
||||||
* 1=简单，2=中等，3=困难
|
|
||||||
*/
|
|
||||||
private Integer difficulty;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 题目考点
|
|
||||||
*/
|
|
||||||
private String examPoint;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 浏览量
|
|
||||||
*/
|
|
||||||
private Integer viewCount;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 创建时间
|
|
||||||
*/
|
|
||||||
private LocalDateTime createdAt;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 更新时间
|
|
||||||
*/
|
|
||||||
private LocalDateTime updatedAt;
|
|
||||||
}
|
|
||||||
@ -1,44 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName QuestionList
|
|
||||||
* @Description 题单实体类
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-16 20:14
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class QuestionList {
|
|
||||||
/*
|
|
||||||
* 题单ID（主键）
|
|
||||||
*/
|
|
||||||
private Integer questionListId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 题单名称
|
|
||||||
*/
|
|
||||||
private String name;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 题单类型
|
|
||||||
*/
|
|
||||||
private Integer type;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 题单描述
|
|
||||||
*/
|
|
||||||
private String description;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 创建时间
|
|
||||||
*/
|
|
||||||
private Date createdAt;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 更新时间
|
|
||||||
*/
|
|
||||||
private Date updatedAt;
|
|
||||||
}
|
|
||||||
@ -1,39 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
import java.util.Date;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName QuestionListItem
|
|
||||||
* @Description 题单-题目关联实体类
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-16 20:15
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class QuestionListItem {
|
|
||||||
/*
|
|
||||||
* 题单ID（联合主键）
|
|
||||||
*/
|
|
||||||
private Integer questionListId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 题目ID（联合主键）
|
|
||||||
*/
|
|
||||||
private Integer questionId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 题单内题目的顺序，从1开始
|
|
||||||
*/
|
|
||||||
private Integer rank;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 创建时间
|
|
||||||
*/
|
|
||||||
private Date createdAt;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 更新时间
|
|
||||||
*/
|
|
||||||
private Date updatedAt;
|
|
||||||
}
|
|
||||||
@ -1,51 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import java.time.LocalDate;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 统计信息实体，包含登录、注册、笔记等统计数据
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
public class Statistic {
|
|
||||||
/**
|
|
||||||
* 主键 ID
|
|
||||||
*/
|
|
||||||
private Integer id;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 当天登录次数
|
|
||||||
*/
|
|
||||||
private Integer loginCount;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 当天注册人数
|
|
||||||
*/
|
|
||||||
private Integer registerCount;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 累计注册总人数
|
|
||||||
*/
|
|
||||||
private Integer totalRegisterCount;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 当天笔记数量
|
|
||||||
*/
|
|
||||||
private Integer noteCount;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 当天提交的笔记数量
|
|
||||||
*/
|
|
||||||
private Integer submitNoteCount;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 累计笔记总数量
|
|
||||||
*/
|
|
||||||
private Integer totalNoteCount;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 统计日期
|
|
||||||
*/
|
|
||||||
private LocalDate date;
|
|
||||||
}
|
|
||||||
@ -1,103 +0,0 @@
|
|||||||
package com.kama.notes.model.entity;
|
|
||||||
|
|
||||||
import lombok.*;
|
|
||||||
|
|
||||||
import java.time.LocalDate;
|
|
||||||
import java.time.LocalDateTime;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ClassName User
|
|
||||||
* @Description 用户实体类
|
|
||||||
* @Author Tong
|
|
||||||
* @LastChangeDate 2024-12-16 10:27
|
|
||||||
* @Version v1.0
|
|
||||||
*/
|
|
||||||
@Data
|
|
||||||
@Getter
|
|
||||||
@Setter
|
|
||||||
@ToString
|
|
||||||
@AllArgsConstructor
|
|
||||||
@NoArgsConstructor
|
|
||||||
public class User {
|
|
||||||
/**
|
|
||||||
* 用户ID（主键）
|
|
||||||
* 系统分配不可修改
|
|
||||||
*/
|
|
||||||
private Long userId;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 账号（唯一）
|
|
||||||
* 注册时自定义，注册后不可修改
|
|
||||||
* 包含数字、字母、下划线
|
|
||||||
*/
|
|
||||||
private String account;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户名
|
|
||||||
* 可修改，包含中文、字母、数字、下划线
|
|
||||||
*/
|
|
||||||
private String username;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 加密后的登录密码
|
|
||||||
*/
|
|
||||||
private String password;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户性别
|
|
||||||
* 1=男，2=女，3=保密
|
|
||||||
*/
|
|
||||||
private Integer gender;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户生日
|
|
||||||
*/
|
|
||||||
private LocalDate birthday;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 头像地址
|
|
||||||
*/
|
|
||||||
private String avatarUrl;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户邮箱
|
|
||||||
*/
|
|
||||||
private String email;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户学校
|
|
||||||
*/
|
|
||||||
private String school;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 用户签名
|
|
||||||
*/
|
|
||||||
private String signature;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 封禁状态
|
|
||||||
* 0=未封禁，1=已封禁
|
|
||||||
*/
|
|
||||||
private Integer isBanned;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 管理员状态
|
|
||||||
* 0=普通用户，1=管理员
|
|
||||||
*/
|
|
||||||
private Integer isAdmin;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 最后登录时间
|
|
||||||
*/
|
|
||||||
private LocalDateTime lastLoginAt;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 创建时间
|
|
||||||
*/
|
|
||||||
private LocalDateTime createdAt;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新时间
|
|
||||||
*/
|
|
||||||
private LocalDateTime updatedAt;
|
|
||||||
}
|
|
||||||
@ -1,15 +0,0 @@
|
|||||||
package com.kama.notes.model.enums.questionList;
|
|
||||||
|
|
||||||
import lombok.Getter;
|
|
||||||
|
|
||||||
@Getter
|
|
||||||
public enum QuestionListType {
|
|
||||||
COMMON(1, "普通题单"),
|
|
||||||
TRAINING_CAMP(2, "训练营题单");
|
|
||||||
private final Integer type;
|
|
||||||
private final String desc;
|
|
||||||
QuestionListType(Integer type, String desc) {
|
|
||||||
this.type = type;
|
|
||||||
this.desc = desc;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,6 +0,0 @@
|
|||||||
package com.kama.notes.model.enums.user;
|
|
||||||
|
|
||||||
public class UserBanned {
|
|
||||||
public static final Integer NOT_BANNED = 0;
|
|
||||||
public static final Integer IS_BANNED = 1;
|
|
||||||
}
|
|
||||||
@ -1,7 +0,0 @@
|
|||||||
package com.kama.notes.model.enums.user;
|
|
||||||
|
|
||||||
public class UserGender {
|
|
||||||
public static final Integer MALE = 1;
|
|
||||||
public static final Integer FEMALE = 2;
|
|
||||||
public static final Integer SECRET = 3;
|
|
||||||
}
|
|
||||||
@ -1,6 +0,0 @@
|
|||||||
package com.kama.notes.model.enums.user;
|
|
||||||
|
|
||||||
public class UserRole {
|
|
||||||
public static final Integer NOT_ADMIN = 0;
|
|
||||||
public static final Integer IS_ADMIN = 1;
|
|
||||||
}
|
|
||||||
@ -1,20 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.category;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CategoryVO {
|
|
||||||
private Integer categoryId;
|
|
||||||
private String name;
|
|
||||||
private Integer parentCategoryId;
|
|
||||||
private List<ChildrenCategoryVO> children;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public static class ChildrenCategoryVO {
|
|
||||||
private Integer categoryId;
|
|
||||||
private String name;
|
|
||||||
private Integer parentCategoryId;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,8 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.category;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CreateCategoryVO {
|
|
||||||
private Integer categoryId;
|
|
||||||
}
|
|
||||||
@ -1,20 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.collection;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CollectionVO {
|
|
||||||
private Integer collectionId;
|
|
||||||
private String name;
|
|
||||||
private String description;
|
|
||||||
/**
|
|
||||||
* 查询收藏夹时，可能会携带的 noteId 参数，这个 noteStatus 可以用来判断该 note 是否被收藏
|
|
||||||
*/
|
|
||||||
private NoteStatus noteStatus;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public static class NoteStatus {
|
|
||||||
private Integer noteId;
|
|
||||||
private Boolean isCollected;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,8 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.collection;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CreateCollectionVO {
|
|
||||||
private Integer collectionId;
|
|
||||||
}
|
|
||||||
@ -1,8 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.note;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class CreateNoteVO {
|
|
||||||
private Integer noteId;
|
|
||||||
}
|
|
||||||
@ -1,8 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.note;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class DownloadNoteVO {
|
|
||||||
private String markdown;
|
|
||||||
}
|
|
||||||
@ -1,12 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.note;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import java.time.LocalDate;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class NoteHeatMapItem {
|
|
||||||
private LocalDate date;
|
|
||||||
private Integer count;
|
|
||||||
private Integer rank;
|
|
||||||
}
|
|
||||||
@ -1,12 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.note;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class NoteRankListItem {
|
|
||||||
private Long userId;
|
|
||||||
private String username;
|
|
||||||
private String avatarUrl;
|
|
||||||
private Integer noteCount;
|
|
||||||
private Integer rank;
|
|
||||||
}
|
|
||||||
@ -1,39 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.note;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
import java.time.LocalDateTime;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class NoteVO {
|
|
||||||
private Integer noteId;
|
|
||||||
private String content;
|
|
||||||
private Boolean needCollapsed = false;
|
|
||||||
private String displayContent;
|
|
||||||
private Integer likeCount;
|
|
||||||
private Integer commentCount;
|
|
||||||
private Integer collectCount;
|
|
||||||
private LocalDateTime createdAt;
|
|
||||||
private SimpleAuthorVO author;
|
|
||||||
private UserActionsVO userActions;
|
|
||||||
private SimpleQuestionVO question;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public static class SimpleAuthorVO {
|
|
||||||
private Long userId;
|
|
||||||
private String username;
|
|
||||||
private String avatarUrl;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public static class UserActionsVO {
|
|
||||||
private Boolean isLiked = false;
|
|
||||||
private Boolean isCollected = false;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public static class SimpleQuestionVO {
|
|
||||||
private Integer questionId;
|
|
||||||
private String title;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,9 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.note;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class Top3Count {
|
|
||||||
private Integer lastMonthTop3Count;
|
|
||||||
private Integer thisMonthTop3Count;
|
|
||||||
}
|
|
||||||
@ -1,8 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.notification;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class NotificationVO {
|
|
||||||
private String content;
|
|
||||||
}
|
|
||||||
@ -1,37 +0,0 @@
|
|||||||
package com.kama.notes.model.vo.question;
|
|
||||||
|
|
||||||
import lombok.Data;
|
|
||||||
|
|
||||||
@Data
|
|
||||||
public class BaseQuestionVO {
|
|
||||||
/*
|
|
||||||
* 问题ID（主键）
|
|
||||||
*/
|
|
||||||
private Integer questionId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 问题所属分类ID
|
|
||||||
*/
|
|
||||||
private Integer categoryId;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 问题标题
|
|
||||||
*/
|
|
||||||
private String title;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 问题难度
|
|
||||||
* 1=简单，2=中等，3=困难
|
|
||||||
*/
|
|
||||||
private Integer difficulty;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 题目考点
|
|
||||||
*/
|
|
||||||
private String examPoint;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* 浏览量
|
|
||||||
*/
|
|
||||||
private Integer viewCount;
|
|
||||||
}
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user