BestHub
Sign in
Shepherd Advanced Notes
Author

Shepherd Advanced Notes

Dedicated to sharing advanced Java technical insights, daily work snippets, and the power of persistent effort.

127
Articles
0
Likes
403
Views
0
Comments
Recent Articles

Latest from Shepherd Advanced Notes

100 recent articles max
Shepherd Advanced Notes
Shepherd Advanced Notes
Sep 24, 2026 · Backend Development

Building a Lightweight Approval Flow with AI: Why Flowable Wasn't the Right Fit

The author details building a lightweight approval flow end-to-end using AI (Codex), covering process modeling, dynamic forms, conditional and parallel branches, task routing, path replay, and analytics, while explaining why Flowable was rejected due to excessive tables, steep learning curve, integration difficulty, and the need for a lightweight, configurable solution.

AI-assisted developmentFlowableapproval flow
0 likes · 29 min read
Building a Lightweight Approval Flow with AI: Why Flowable Wasn't the Right Fit
Shepherd Advanced Notes
Shepherd Advanced Notes
Aug 24, 2026 · Artificial Intelligence

Connect Claude Code & Codex to DeepSeek V4 Pro: Config, Cost Analysis & Verification

This guide details how to configure Claude Code and Codex to use DeepSeek V4 Pro instead of official APIs, covering client installation, API key setup, three configuration methods (CC Switch, official scripts, manual), model pricing comparisons with cost calculations for long tasks, verification steps, and troubleshooting common issues.

0 likes · 23 min read
Connect Claude Code & Codex to DeepSeek V4 Pro: Config, Cost Analysis & Verification
Shepherd Advanced Notes
Shepherd Advanced Notes
Jul 28, 2026 · Artificial Intelligence

Master the MCP Protocol: Core Concepts, Implementation Details, and Best‑Practice Applications

This article provides a systematic deep‑dive into the Model Context Protocol (MCP), explaining its purpose, architecture, core capabilities, data and transport layers, and step‑by‑step guides for building both local and remote MCP servers with Python, while also covering security, permission, and best‑practice recommendations for real‑world AI applications.

AI IntegrationBest PracticesMCP
0 likes · 37 min read
Master the MCP Protocol: Core Concepts, Implementation Details, and Best‑Practice Applications
Shepherd Advanced Notes
Shepherd Advanced Notes
Jul 10, 2026 · Backend Development

Why Spring MVC File Upload Parameters Disappear: Multipart, Filters, and Request Body Pitfalls

The article details a puzzling Spring MVC file‑upload issue where parameters vanish when the token is sent in a header, tracing the problem through multipart/form‑data parsing, premature request‑body consumption by custom filters, request.getParameter() side effects, and the HiddenHttpMethodFilter, and provides the correct remediation steps.

Spring MVCToken Authenticationfile upload
0 likes · 15 min read
Why Spring MVC File Upload Parameters Disappear: Multipart, Filters, and Request Body Pitfalls
Shepherd Advanced Notes
Shepherd Advanced Notes
Jun 24, 2026 · Backend Development

Boosting Throughput 10×: Architecture Evolution and Tuning for High‑Concurrency Batch Processing

The article details how a sluggish batch‑processing system handling millions of records was redesigned with XXL‑JOB sharding, Redis‑based dynamic task distribution, cursor pagination, and selective transaction scopes, achieving nearly ten‑fold throughput improvement while addressing resource contention, load‑balancing, and reliable result reconciliation.

Batch ProcessingJavaMySQL
0 likes · 19 min read
Boosting Throughput 10×: Architecture Evolution and Tuning for High‑Concurrency Batch Processing
Shepherd Advanced Notes
Shepherd Advanced Notes
Mar 27, 2026 · Backend Development

Stop Using cat Blindly: Practical Linux Commands for GB‑Scale Backend Log Troubleshooting

When production logs grow to gigabytes, opening them with editors like vi or cat can crash your system; this article systematically presents essential Linux commands—grep, awk, sed, tail, less, and their pipelines—showing how to efficiently search, filter, and analyze massive logs for rapid backend issue resolution.

Linuxawkbackend debugging
0 likes · 18 min read
Stop Using cat Blindly: Practical Linux Commands for GB‑Scale Backend Log Troubleshooting
Shepherd Advanced Notes
Shepherd Advanced Notes
Feb 4, 2026 · Backend Development

Mastering Java Code Comments: The Ultimate Guide to High‑Quality, Readable, Architecture‑Level Documentation

The article explains why high‑quality Javadoc is essential for enterprise‑level Java backend projects, walks through the most common Javadoc tags and HTML elements, provides concrete code examples—including @param, @return, @throws, @see, @deprecated—and shows how thorough comments improve readability, maintainability, and serve as a catalyst for refactoring.

Backend DevelopmentBest PracticesJava
0 likes · 14 min read
Mastering Java Code Comments: The Ultimate Guide to High‑Quality, Readable, Architecture‑Level Documentation
Shepherd Advanced Notes
Shepherd Advanced Notes
Jan 13, 2026 · Fundamentals

How to Name Code for Maximum Readability and Maintainability

The article explains why clean, well‑named code is essential for productivity, outlines the hidden costs of messy naming, and provides concrete guidelines and examples—including variable, class, package, and method naming patterns—to help developers write code that communicates clearly with both machines and engineers.

Best Practicescode namingmaintainability
0 likes · 19 min read
How to Name Code for Maximum Readability and Maintainability
Shepherd Advanced Notes
Shepherd Advanced Notes
Nov 28, 2025 · Backend Development

Hard‑Learned MyBatis‑Plus Pitfalls and How to Avoid Them in Production

The article reviews the most common MyBatis‑Plus traps encountered in large‑scale Java services—duplicate Snowflake IDs, batch‑insert reordering, enum storage mismatches, camel‑case mapping errors, auto‑fill loss, and JSON field disappearance—explaining each root cause, illustrating it with real code snippets, and providing concrete solutions to keep production systems stable.

Auto-fillBatch InsertEnum Mapping
0 likes · 19 min read
Hard‑Learned MyBatis‑Plus Pitfalls and How to Avoid Them in Production